Premium Feature
Document Verification is available as a premium feature. Contact Sales to inquire more about access. If you're an existing customer, reach out to your Account Manager or to [email protected].
Document Verification object returns the results of a Document Verification associated with the business depending on the type of verification.
| Property | Type | Definition |
|---|---|---|
| object | string | The type of object returned. Always set to document_verification. |
| id | string | The unique identifier of the Document Verification. |
| status | string | The status of the Document Verification. Can be completed, pending, or failed. The status will be failed if the document does not upload properly, refer to error for more details. |
| verified | boolean | Whether or not the Document Verification was successful based on whether the document is not fraudulent, whether the document_type is valid for the verification type, if the verification_fields match the extracted_fields, and the extracted_fields.business_name matches the associated business' name. |
| verification_fields | object | The fields that were submitted for verification. |
| extracted_fields | object | The fields extracted from the submitted document. Inclusive of verification_fields as well as business_name and document_date. |
| verification_type | string | The type of verification. Can be address or ein. |
| created_at | string | The timestamp of when the Document Verification was created. |
| document_type | string | The type of document submitted determined during the verification process. Valid document types for address verification are bank statement and utility bill. valid document type for EIN verification is an EIN document. |
| error | string | If the document fails to upload asynchronously, this object will contain a message describing the error that occurred. This is only not null when status is failed. |
Address Verification
{
"object": "document_verification",
"id": "1",
"status": "completed",
"verified": true,
"verification_fields": {
"address_line1": "123 Main Street",
"city": "Brooklyn",
"state": "NY",
"postal_code": "00000"
},
"extracted_fields": {
"business_name": "Middesk, Inc.",
"address_line1": "123 Main Street",
"city": "Brooklyn",
"state": "NY",
"postal_code": "00000",
"document_date": "01/25/2019"
},
"verification_type": "address",
"created_at": "2023-04-12T18:21:13.537Z",
"document_type": "bank_statement",
"document": {
"object": "document",
"id": "123",
"document_type": "Verification document",
"filename": "sample.pdf",
"content_type": "application/pdf",
"size": 63190,
"download_url": "",
"created_at": "2023-04-05T16:18:57.867Z",
"source": {
"type": "document_verification",
"id": "123",
"metadata": {
"status": "completed"
}
},
"filing_date": null,
"metadata": {}
}
}
EIN Verification
{
"object": "document_verification",
"id": "2",
"status": "completed",
"verified": false,
"verification_fields": {
"ein": "123456789"
},
"extracted_fields": {
"business_name": "Middesk, Inc.",
"ein": "123456798",
"document_date": "01/25/2019"
},
"verification_type": "ein",
"created_at": "2023-04-11T18:23:12.317Z",
"document_type": "ein",
"document": {
"object": "document",
"id": "123",
"document_type": "Verification document",
"filename": "sample.pdf",
"content_type": "application/pdf",
"size": 63190,
"download_url": "",
"created_at": "2023-04-05T16:18:57.867Z",
"source": {
"type": "document_verification",
"id": "123",
"metadata": {
"status": "completed"
}
},
"filing_date": null,
"metadata": {}
}
}