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
}
AttributeDescription
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.