Business object
This page describes the business object, used to perform verification and due diligence of companies.
Business attributes
Middesk surfaces many pieces of information about each business.
| Property | Type | Description | Guaranteed |
|---|---|---|---|
| object | string | A definition of the type of object returned. | yes |
| id | string | Middesk-generated unique identifier for the business. | yes |
| external_id | string | Identifier from a non-Middesk system. | no, populated if external_id was provided when creating the business |
| unique_external_id | string | Unique identifier from a non-Middesk system. If a new business is created using the same unique_external_id, Middesk will not create that business. This can be used to prevent duplicate businesses. | no |
| name | string | The given name for the company. | yes |
| created_at | timestamp | yes | |
| updated_at | timestamp | no | |
| status | string | The current status of the business lifecycle. One of open, pending, in_audit, in_review, approved, or rejected. | yes |
| tin | object | Information about the employer identification number. | Guaranteed if TIN provided when creating the business. null if no TIN was provided. |
| formation | object | Information about the formation of the business. | nullable |
| registrations | object[] | List and details of all known registrations. | yes, can be an empty array if no registrations found for the business. |
| names | object[] | Details about the business names. | yes |
| addresses | object[] | All known addresses tied to a business entity. | yes |
| review | object | The business Review. | yes, empty until the business moves to in_review, approved, or rejected |
| orders | object[] | Determine what information is fetched on the Business. The orders field contains a business’s most recently updated orders per package. A full list of a business’s orders can be fetched using the business orders list endpoint. | yes |
| people | object[] | Information about people. | yes, can be an empty array |
| policy_results | policy_result[] | Information about policy results. | yes, can be an empty array |
| profiles | object[] | Information about profile. | yes, can be an empty array |
| documents | object[] | Information about document. | yes, can be an empty array |
| supported_document_types | string[] | Only present if Document Retrieval is enabled for the account. This specifies the document types available for retrieval for this particular Business. The valid values are Articles of Incorporation and Certificate of Good Standing. | yes, can be an empty array |
| monitor | object | The Monitor on this Business, if present. | nullable |
| adverse_media_screening | object | Information about Adverse Media. | nullable |
| bankruptcies | object[] | Information about Bankruptcy | yes, can be an empty array |
| phone_numbers | object[] | Information about phone numbers. | yes, can be an empty array |
| industry_classification | object | Information about industry classification. | nullable |
| liens | object[] | Information about Liens | yes, can be an empty array |
| tags | string[] | Custom tags you can add to a Business at creation for analytics, tracking, and various other use cases. | yes, can be an empty array |
| requester | object | null | The requester who initiated the business creation. Contains name and type fields. | nullable |
| assignee_id | string (uuid) | null | The ID of the user assigned to review this business. | nullable |
| business_batch_id | string (uuid) | null | The ID of the batch this business belongs to, if created as part of a batch. | nullable |
| certifications | object[] | Information about certifications associated with the business. | yes, can be an empty array |
| fmcsa_registrations | object[] | FMCSA (Federal Motor Carrier Safety Administration) registration records. | yes, can be an empty array |
| loans | object[] | null | Loan records associated with the business. | nullable |
| litigations | object[] | Information about litigation records. | yes, can be an empty array |
| politically_exposed_person_screening | object | null | Information about PEP screening results. | nullable |
| signal | object | null | The signal risk score for the business. | nullable |
| submitted | object | The original submitted attributes used to create the business. | yes |
| subscription | object | null | The monitoring subscription for this business. | nullable |
| subscription_availability | object | null | Indicates which event types are available for monitoring subscription. Keys include bankruptcy, certification, registration, tin, watchlist_result, and lien, each with a value of subscribable or account_unsubscribable. | nullable |
| tax_exempt_organization | object | null | Tax exempt organization data if the business is registered as tax exempt. | nullable |
| watchlist | object | Information about the watchlist screenings | null until the business moves to in_review, approved, or rejected |
| website | object | Website information | nullable |
