Retrieving a Company's Federal EIN

A company's Federal Employer Identification Number (FEIN) is stored as a company tax parameter. It is not a field on the Company object, and it is not retrieved via the Federal EIN Verification object — that object only exposes the status of Check's verification process.

Fetching the FEIN

To retrieve a company's FEIN, call the List a company's tax parameters API and find the result whose name is federal_ein. The FEIN is the value of that parameter's setting.value field.

curl -X GET \
  https://sandbox.checkhq.com/company_tax_params/com_8BDDxUvOZcFVeiuAGne8 \
  -H 'Authorization: Bearer YOUR_API_KEY'

EXAMPLE RESPONSE

{
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "spa_h7zSw4NITCtef4Taf5yA",
      "label": "Federal Employer Identification Number",
      "description": "Enter your FEIN in the following format XX-XXXXXXX",
      "name": "federal_ein",
      "type": "string",
      "jurisdiction": "jur_oFIe7BAqBbaz4tB6bcfV",
      "submitter": "company",
      "setting": {
        "applied_for": null,
        "value": "12-3456789",
        "effective_start": "1900-01-01"
      }
    },
    ...,
  ]
}

If the setting is null, the company's FEIN has not yet been provided to Check.

Fetching it directly

You can also skip listing entirely and fetch the FEIN setting directly with the Get company tax parameter setting API. Tax parameter IDs are deterministic and stable across both Sandbox and Production environments — so the federal_ein parameter's ID is spa_h7zSw4NITCtef4Taf5yA everywhere.

curl -X GET \
  https://sandbox.checkhq.com/company_tax_params/com_8BDDxUvOZcFVeiuAGne8/settings/spa_h7zSw4NITCtef4Taf5yA \
  -H 'Authorization: Bearer YOUR_API_KEY'

EXAMPLE RESPONSE

{
  "id": "spa_h7zSw4NITCtef4Taf5yA",
  "jurisdiction": "jur_oFIe7BAqBbaz4tB6bcfV",
  "applied_for": null,
  "value": "12-3456789",
  "effective_start": "1900-01-01",
  "settings": [
    {
      "value": "12-3456789",
      "effective_start": "1900-01-01",
      "created_at": "2022-07-11T19:37:31.589206Z"
    }
  ]
}

📘
For details on how Check verifies a company's legal name and FEIN with the IRS, see Automatic Federal EIN Verification. For setting or updating the FEIN and other tax parameters, see Tax Parameters.