Skip to main content
GET
/
v1
/
companies
/
{jurisdiction_code}
/
{company_number}
Get entity record
curl --request GET \
  --url https://api.govfiles.dev/v1/companies/{jurisdiction_code}/{company_number} \
  --header 'X-API-Key: <api-key>'
{
  "company_number": "<string>",
  "name": "<string>",
  "jurisdiction_code": "<string>",
  "retrieved_at": "2023-12-25",
  "incorporation_date": "2023-12-25",
  "dissolution_date": "2023-12-25",
  "current_status": "<string>",
  "company_type": "<string>",
  "registry_url": "<string>",
  "website": "<string>",
  "telephone_number": "<string>",
  "fax_number": "<string>",
  "registered_address": {
    "street_address": "<string>",
    "locality": "<string>",
    "region": "<string>",
    "postal_code": "<string>",
    "country": "<string>",
    "country_code": "<string>"
  },
  "headquarters_address": {
    "street_address": "<string>",
    "locality": "<string>",
    "region": "<string>",
    "postal_code": "<string>",
    "country": "<string>",
    "country_code": "<string>"
  },
  "mailing_address": {
    "street_address": "<string>",
    "locality": "<string>",
    "region": "<string>",
    "postal_code": "<string>",
    "country": "<string>",
    "country_code": "<string>"
  },
  "officers": [
    {
      "name": "<string>",
      "position": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "uid": "<string>",
      "other_attributes": {
        "date_of_birth": "2023-12-25",
        "nationality": "<string>",
        "person_uid": "<string>",
        "address": {
          "street_address": "<string>",
          "locality": "<string>",
          "region": "<string>",
          "postal_code": "<string>",
          "country": "<string>",
          "country_code": "<string>"
        }
      }
    }
  ],
  "filings": [
    {
      "date": "2023-12-25",
      "description": "<string>",
      "uid": "<string>",
      "url": "<string>",
      "filing_type_code": "<string>",
      "filing_type_name": "<string>",
      "other_attributes": {}
    }
  ],
  "identifiers": [
    {
      "uid": "<string>",
      "identifier_system_code": "<string>"
    }
  ],
  "industry_codes": [
    {
      "code": "<string>",
      "code_scheme_id": "<string>",
      "name": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25"
    }
  ],
  "previous_names": [
    {
      "company_name": "<string>",
      "con_date": "2023-12-25",
      "start_date": "2023-12-25"
    }
  ],
  "alternative_names": [
    {
      "company_name": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "language": "<string>"
    }
  ],
  "share_parcels": [
    {
      "number_of_shares": 123,
      "percentage_of_shares": 50,
      "percentage_of_shares_min": 50,
      "percentage_of_shares_max": 50,
      "voting_percentage": 50,
      "voting_percentage_min": 50,
      "voting_percentage_max": 50,
      "share_class": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "sample_date": "2023-12-25",
      "shareholders": [
        {
          "name": "<string>",
          "jurisdiction": "<string>",
          "company_number": "<string>",
          "identifier": "<string>",
          "address": {
            "street_address": "<string>",
            "locality": "<string>",
            "region": "<string>",
            "postal_code": "<string>",
            "country": "<string>",
            "country_code": "<string>"
          },
          "address_country": "<string>"
        }
      ]
    }
  ],
  "total_shares": {
    "number": 123,
    "share_class": "<string>"
  },
  "subsequent_registrations": [
    {}
  ],
  "alternate_registrations": [
    {}
  ],
  "all_attributes": {
    "jurisdiction_of_origin": "<string>",
    "home_company_number": "<string>",
    "home_legal_name": "<string>",
    "registered_agent_address": "<string>",
    "registered_agent_name": "<string>",
    "number_of_employees": "<string>",
    "merged_into": {
      "surviving_company": {
        "name": "<string>",
        "company_number": "<string>",
        "jurisdiction": "<string>"
      },
      "effective_date": "2023-12-25"
    }
  }
}
Look up a single company when you already know its registry-issued identifier. The response is the Company object — the same record embedded under results[].company in search results. 
curl -s 'https://api.govfiles.dev/v1/companies/us_de/7218394' \
  -H "X-API-Key: $GOVFILES_API_KEY"
jurisdiction_code is case-insensitive and must be one of the supported jurisdiction codes. company_number must match exactly as it appears on the record. 404 is returned when the company_number is not present in the given jurisdiction — including the case where the same number exists under a different jurisdiction.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
jurisdiction_code
string
required

Jurisdiction code, e.g. us_de or us_ca.

​
company_number
string
required

Registry-assigned entity number.

Response

Entity record.

​
company_number
string
required
Minimum string length: 1
​
name
string
required
Minimum string length: 1
​
jurisdiction_code
string
required
Required string length: 2 - 5
​
retrieved_at
string<date>
required
​
incorporation_date
string<date> | null
​
dissolution_date
string<date> | null
​
current_status
string | null
​
company_type
string | null
​
registry_url
string | null
​
website
​
telephone_number
string | null
Minimum string length: 4
​
fax_number
string | null
Minimum string length: 4
​
branch
enum<string> | null
Available options:
F,
L
​
registered_address

Structured address. The schema also allows a plain string (min length 2) -- use Address | str on parent fields to support both forms.

​
headquarters_address

Structured address. The schema also allows a plain string (min length 2) -- use Address | str on parent fields to support both forms.

​
mailing_address

Structured address. The schema also allows a plain string (min length 2) -- use Address | str on parent fields to support both forms.

​
officers
object[] | null
​
filings
object[] | null
​
identifiers
object[] | null
​
industry_codes
object[] | null
​
previous_names
object[] | null
​
alternative_names
object[] | null
​
share_parcels
object[] | null
​
total_shares
object
​
subsequent_registrations
object[] | null
​
alternate_registrations
object[] | null
​
all_attributes
object

Extended fields for foreign-qualified entities and registered agents.