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

# GovFiles: Get Company V2

> Retrieve the complete high-quality company record for a known jurisdiction code and registry company number. Includes SDK V2 examples, schemas, and cost.

Retrieve the complete high-quality company record for a known jurisdiction code and registry company number.

> [!NOTE]
>
> Tool ID: `govfiles_get_company_v2`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'govfiles_get_company_v2',
  {
    "jurisdiction_code": "example",
    "company_number": "example"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute govfiles_get_company_v2 --input '{
  "jurisdiction_code": "example",
  "company_number": "example"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "jurisdiction_code": "examp",
    "entity_number": "example",
    "legal_name": "Example",
    "status": "active",
    "legal_form": "llc",
    "domicile": "domestic",
    "search_url": "https://example.com",
    "as_of": "2026-01-15"
  }
}
```

Use `deepline describe govfiles_get_company_v2 --json` for the latest machine-readable contract.

## Input reference

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

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.jurisdiction_code` | `string` | Yes | — | Jurisdiction code, e.g. `us_de` or `us_ca`. |
| `payload.company_number` | `string` | Yes | — | Registry-assigned entity number. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve a single company by its jurisdiction code and registry company number.",
    "properties": {
      "jurisdiction_code": {
        "type": "string",
        "description": "Jurisdiction code, e.g. `us_de` or `us_ca`."
      },
      "company_number": {
        "type": "string",
        "description": "Registry-assigned entity number."
      }
    },
    "required": [
      "jurisdiction_code",
      "company_number"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.kind` | `"company"` | No | `"company"` | — |
| `result.data.jurisdiction_code` | `string` | Yes | — | Minimum length: 2. Maximum length: 5. |
| `result.data.entity_number` | `string` | Yes | — | Minimum length: 1. |
| `result.data.legal_name` | `string` | Yes | — | Minimum length: 1. |
| `result.data.status` | `"active" \| "inactive" \| "dissolved" \| "suspended" \| "merged" \| "withdrawn" \| "unknown"` | Yes | — | Allowed: `active`, `inactive`, `dissolved`, `suspended`, `merged`, `withdrawn`, `unknown`. |
| `result.data.status_raw` | `string \| null` | No | — | — |
| `result.data.legal_form` | `"llc" \| "corporation" \| "nonprofit" \| "limited_partnership" \| "limited_liability_partnership" \| "partnership" \| "trust" \| "other" \| "unknown"` | Yes | — | Allowed: `llc`, `corporation`, `nonprofit`, `limited_partnership`, `limited_liability_partnership`, `partnership`, `trust`, `other`, `unknown`. |
| `result.data.legal_form_raw` | `string \| null` | No | — | — |
| `result.data.domicile` | `"domestic" \| "foreign" \| "unknown"` | Yes | — | Allowed: `domestic`, `foreign`, `unknown`. |
| `result.data.formed_on` | `string \| null` | No | — | Format: `date`. |
| `result.data.dissolved_on` | `string \| null` | No | — | Format: `date`. |
| `result.data.addresses` | `object \| null` | No | — | — |
| `result.data.addresses.registered` | `object \| null` | No | — | — |
| `result.data.addresses.registered.raw` | `string \| null` | No | — | — |
| `result.data.addresses.registered.street_address` | `string \| null` | No | — | — |
| `result.data.addresses.registered.street_address_2` | `string \| null` | No | — | — |
| `result.data.addresses.registered.locality` | `string \| null` | No | — | — |
| `result.data.addresses.registered.region` | `string \| null` | No | — | — |
| `result.data.addresses.registered.postal_code` | `string \| null` | No | — | — |
| `result.data.addresses.registered.country` | `string \| null` | No | — | — |
| `result.data.addresses.registered.country_code` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters` | `object \| null` | No | — | — |
| `result.data.addresses.headquarters.raw` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters.street_address` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters.street_address_2` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters.locality` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters.region` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters.postal_code` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters.country` | `string \| null` | No | — | — |
| `result.data.addresses.headquarters.country_code` | `string \| null` | No | — | — |
| `result.data.addresses.mailing` | `object \| null` | No | — | — |
| `result.data.addresses.mailing.raw` | `string \| null` | No | — | — |
| `result.data.addresses.mailing.street_address` | `string \| null` | No | — | — |
| `result.data.addresses.mailing.street_address_2` | `string \| null` | No | — | — |
| `result.data.addresses.mailing.locality` | `string \| null` | No | — | — |
| `result.data.addresses.mailing.region` | `string \| null` | No | — | — |
| `result.data.addresses.mailing.postal_code` | `string \| null` | No | — | — |
| `result.data.addresses.mailing.country` | `string \| null` | No | — | — |
| `result.data.addresses.mailing.country_code` | `string \| null` | No | — | — |
| `result.data.names` | `array \| null` | No | — | — |
| `result.data.names[].name` | `string` | Yes | — | Minimum length: 1. |
| `result.data.names[].kind` | `"previous_legal" \| "trading" \| "alias"` | Yes | — | Allowed: `previous_legal`, `trading`, `alias`. |
| `result.data.names[].started_on` | `string \| null` | No | — | Format: `date`. |
| `result.data.names[].ended_on` | `string \| null` | No | — | Format: `date`. |
| `result.data.parties` | `array \| null` | No | — | — |
| `result.data.parties[].type` | `"company" \| "person" \| "unknown"` | Yes | — | Allowed: `company`, `person`, `unknown`. |
| `result.data.parties[].name` | `string` | Yes | — | Minimum length: 1. |
| `result.data.parties[].roles` | `array` | No | — | — |
| `result.data.parties[].roles[].kind` | `"registered_agent" \| "officer" \| "manager" \| "member" \| "governor" \| "owner" \| "incorporator" \| "shareholder" \| "other" \| "unknown"` | Yes | — | Allowed: `registered_agent`, `officer`, `manager`, `member`, `governor`, `owner`, `incorporator`, `shareholder`, `other`, `unknown`. |

The table shows the first 50 fields. Expand the raw schema below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe govfiles_get_company_v2 --json`.

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.14` per pricing unit.

## Related documentation

* [GovFiles provider guide](https://deepline.com/docs/providers/govfiles/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.