> ## Documentation Index
> Fetch the complete documentation index at: https://docs.govfiles.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a company by id

> Retrieve a single company by its jurisdiction code and registry company number.

Look up a single company when you already know its registry-issued identifier. The response is the [company entity](/guides/company-schema) — the same record embedded under `results[].company` in [search results](/api-reference/endpoints/searchcompanies).

```bash theme={null}
curl -s 'https://api.govfiles.dev/v2/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](/guides/jurisdictions). `company_number` is the registry-issued identifier returned as `entity_number` on the entity, and 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.


## OpenAPI

````yaml GET /v2/companies/{jurisdiction_code}/{company_number}
openapi: 3.1.0
info:
  title: govfiles Corporate Entity API
  version: 0.2.0
  description: >-
    Search US business entity records by name, registry number, jurisdiction, or
    status.
servers:
  - url: https://api.govfiles.dev
security: []
tags:
  - name: Health
    description: Service health checks.
  - name: Companies
    description: Corporate entity search and lookup endpoints.
  - name: Officers
    description: Officer, director, and agent search endpoints.
  - name: Account
    description: Account and billing endpoints.
paths:
  /v2/companies/{jurisdiction_code}/{company_number}:
    get:
      tags:
        - Companies
      summary: Get a company
      description: >-
        Retrieve a single company by its jurisdiction code and registry company
        number.
      operationId: getCompanyV2
      parameters:
        - name: jurisdiction_code
          in: path
          required: true
          schema:
            type: string
          description: Jurisdiction code, e.g. `us_de` or `us_ca`.
        - name: company_number
          in: path
          required: true
          schema:
            type: string
          description: Registry-assigned entity number.
      responses:
        '200':
          description: Company entity.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicCompanyEntity'
        '401':
          description: Missing or invalid API key.
        '402':
          description: Insufficient credits.
        '404':
          description: Entity record not found.
        '422':
          description: Validation error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    PublicCompanyEntity:
      properties:
        kind:
          type: string
          const: company
          default: company
        jurisdiction_code:
          type: string
          maxLength: 5
          minLength: 2
        entity_number:
          type: string
          minLength: 1
        legal_name:
          type: string
          minLength: 1
        status:
          $ref: '#/components/schemas/EntityStatusKind'
        status_raw:
          type:
            - string
            - 'null'
        legal_form:
          $ref: '#/components/schemas/LegalForm'
        legal_form_raw:
          type:
            - string
            - 'null'
        domicile:
          $ref: '#/components/schemas/Domicile'
        formed_on:
          type:
            - string
            - 'null'
          format: date
        dissolved_on:
          type:
            - string
            - 'null'
          format: date
        addresses:
          anyOf:
            - $ref: '#/components/schemas/EntityAddresses'
            - type: 'null'
        names:
          items:
            $ref: '#/components/schemas/EntityName'
          type:
            - array
            - 'null'
        parties:
          items:
            $ref: '#/components/schemas/PublicParty'
          type:
            - array
            - 'null'
        filings:
          items:
            $ref: '#/components/schemas/EntityFiling'
          type:
            - array
            - 'null'
        relationships:
          items:
            $ref: '#/components/schemas/EntityRelationship'
          type:
            - array
            - 'null'
        contact:
          anyOf:
            - $ref: '#/components/schemas/Contact'
            - type: 'null'
        industry_codes:
          items:
            $ref: '#/components/schemas/IndustryCode'
          type:
            - array
            - 'null'
        identifiers:
          items:
            $ref: '#/components/schemas/Identifier'
          type:
            - array
            - 'null'
        entity_url:
          type:
            - string
            - 'null'
        search_url:
          type: string
        as_of:
          type: string
          format: date
      type: object
      required:
        - jurisdiction_code
        - entity_number
        - legal_name
        - status
        - legal_form
        - domicile
        - search_url
        - as_of
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    EntityStatusKind:
      type: string
      enum:
        - active
        - inactive
        - dissolved
        - suspended
        - merged
        - withdrawn
        - unknown
    LegalForm:
      type: string
      enum:
        - llc
        - corporation
        - nonprofit
        - limited_partnership
        - limited_liability_partnership
        - partnership
        - trust
        - other
        - unknown
    Domicile:
      type: string
      enum:
        - domestic
        - foreign
        - unknown
    EntityAddresses:
      properties:
        registered:
          anyOf:
            - $ref: '#/components/schemas/EntityAddress'
            - type: 'null'
        headquarters:
          anyOf:
            - $ref: '#/components/schemas/EntityAddress'
            - type: 'null'
        mailing:
          anyOf:
            - $ref: '#/components/schemas/EntityAddress'
            - type: 'null'
      type: object
    EntityName:
      properties:
        name:
          type: string
          minLength: 1
        kind:
          $ref: '#/components/schemas/NameKind'
        started_on:
          type:
            - string
            - 'null'
          format: date
        ended_on:
          type:
            - string
            - 'null'
          format: date
      type: object
      required:
        - name
        - kind
    PublicParty:
      properties:
        type:
          $ref: '#/components/schemas/EntityKind'
        name:
          type: string
          minLength: 1
        roles:
          items:
            $ref: '#/components/schemas/PublicRole'
          type: array
        address:
          anyOf:
            - $ref: '#/components/schemas/EntityAddress'
            - type: 'null'
      type: object
      required:
        - type
        - name
    EntityFiling:
      properties:
        id:
          type:
            - string
            - 'null'
        title:
          type:
            - string
            - 'null'
        filed_on:
          type: string
          format: date
        type:
          anyOf:
            - $ref: '#/components/schemas/FilingType'
            - type: 'null'
        url:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'
      type: object
      required:
        - filed_on
    EntityRelationship:
      properties:
        kind:
          $ref: '#/components/schemas/RelationshipKind'
        entity:
          $ref: '#/components/schemas/EntityRef'
        effective_date:
          type:
            - string
            - 'null'
          format: date
      type: object
      required:
        - kind
        - entity
    Contact:
      properties:
        websites:
          items:
            type: string
          type:
            - array
            - 'null'
        phone:
          type:
            - string
            - 'null'
        fax:
          type:
            - string
            - 'null'
      type: object
    IndustryCode:
      properties:
        code:
          type: string
          minLength: 1
        scheme:
          type: string
        description:
          type:
            - string
            - 'null'
      type: object
      required:
        - code
        - scheme
    Identifier:
      properties:
        scheme:
          type: string
        value:
          type: string
          minLength: 1
      type: object
      required:
        - scheme
        - value
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
    EntityAddress:
      properties:
        raw:
          type:
            - string
            - 'null'
        street_address:
          type:
            - string
            - 'null'
        locality:
          type:
            - string
            - 'null'
        region:
          type:
            - string
            - 'null'
        postal_code:
          type:
            - string
            - 'null'
        country:
          type:
            - string
            - 'null'
        country_code:
          type:
            - string
            - 'null'
        latitude:
          type:
            - number
            - 'null'
          maximum: 90
          minimum: -90
        longitude:
          type:
            - number
            - 'null'
          maximum: 180
          minimum: -180
      type: object
    NameKind:
      type: string
      enum:
        - previous_legal
        - trading
        - alias
    EntityKind:
      type: string
      enum:
        - company
        - person
        - license
        - unknown
    PublicRole:
      properties:
        kind:
          $ref: '#/components/schemas/PartyRoleKind'
        title:
          type:
            - string
            - 'null'
        ownership_percentage:
          type:
            - number
            - 'null'
        started_on:
          type:
            - string
            - 'null'
          format: date
        ended_on:
          type:
            - string
            - 'null'
          format: date
      type: object
      required:
        - kind
    FilingType:
      properties:
        code:
          type:
            - string
            - 'null'
        name:
          type:
            - string
            - 'null'
      type: object
    RelationshipKind:
      type: string
      enum:
        - merged_into
        - home_entity
        - subsequent_registration
        - alternate_registration
    EntityRef:
      properties:
        name:
          type:
            - string
            - 'null'
        jurisdiction_code:
          type:
            - string
            - 'null'
        entity_number:
          type:
            - string
            - 'null'
      type: object
    PartyRoleKind:
      type: string
      enum:
        - registered_agent
        - officer
        - manager
        - member
        - governor
        - owner
        - incorporator
        - shareholder
        - other
        - unknown
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````