The Federal EIN Verification object

The Federal EIN Verification object captures company FEIN verification information, including status, legal name and FEIN. For more details on Check's Automatic Federal EIN Verification, see the Automatic Federal EIN Verification Guide.

{
    "id": "fev_D3FeAyR6Ao3LZiO3j6d2",
    "company": "com_097YZQgrXZQb8VHtI76S",
    "legal_name": "Stark Industries, Inc.",
    "federal_ein": "12-3456785",
    "status": "processing",
    "start_time": "2022-07-11T19:37:31.589206Z",
    "end_time": null,
    "error": null
}

Attribute	Description
id string	Unique identifier for the Federal EIN Verification.
company string	Unique identifier of the company associated with this verification.
legal_name string	The legal name of the company at the time the Federal EIN Verification processing began. Note that the legal name of the company could have changed in the interim, but that will not affect this specific verification process. Rather, it would have resulted in a new verification attempt (and associated Federal EIN Verification object).
federal_ein string	The Federal EIN used for this verification. This is the value that was set at the time processing began. Note that the FEIN of the company could have changed in the interim, but that will not affect this verification process.
status string	Status of this verification. One of `processing`, `verified`, `rejected` or `final_rejected`. More details on status and their meaning can be found in the Automatic Federal EIN Verification Guide
start_time YYYY-MM-DDTHH:MM:SS	A timestamp representing when the verification was started.
end_time YYYY-MM-DDTHH:MM:SS or null	A timestamp representing when the verification was completed. If the process is on-going, it will be `null`.
error nullable string	An optional value that shows why the request couldn't be processed. While the status might be rejected in these cases, it doesn't necessarily mean the legal name and FEIN are incorrect.