> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.middesk.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server. # Business object > Lists the contents of a business record. This page describes the `business` object, used to perform verification and due diligence of companies. **`Example JSON response: Business Verification-Verify`** ```json title="Example JSON response: Business Verification-Verify" { "object": "business", "id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b", "name": "Middesk Inc. ", "created_at": "2023-01-21T06:43:23.313Z", "updated_at": "2023-01-21T06:44:07.184Z", "status": "approved", "addresses": [ { "object": "address", "address_line1": "2180 Bryant St Ste 210", "address_line2": null, "city": "San Francisco", "state": "CA", "postal_code": "94110-2141", "full_address": "2180 Bryant St Ste 210, San Francisco, CA 94110-2141", "latitude": 37.75938, "longitude": -122.40994, "created_at": "2019-01-30T23:49:01.100Z", "updated_at": "2019-01-30T23:49:01.100Z" } ], "orders": [ { "object": "order", "id": "12e97a44-e4ca-498f-912a-e6c72f632807", "completed_at": "2023-07-18T19:47:12.392Z", "created_at": "2023-07-18T19:47:09.886Z", "product": "business_verification_verify", "package": "business_verification_verify", "requester": { "name": "Jane Doe" }, "status": "completed", "subproducts": [], "updated_at": "2023-07-18T19:47:12.396Z" }, { "object": "order", "id": "1db81bfc-f204-5e4d-8238-fea683bd071c", "completed_at": "2023-07-18T19:47:11.765Z", "created_at": "2023-07-18T19:47:09.850Z", "product": "website", "package": "website", "requester": { "name": "Jane Doe" }, "status": "completed", "subproducts": [], "updated_at": "2023-07-18T19:47:11.769Z" } ], "people": [ { "object": "person", "name": "John Doe", "titles": [ { "object": "person_title", "title": "president" }, { "object": "person_titles", "title": "registered agent" } ], "sources": [ { "id": "5d1308ad-0d33-472d-8e61-ed223649d074", "type": "registration", "metadata": { "state": "CA", "status": "active", "file_number": "C4221590" } } ] } ], "policy_results": [ { "object": "policy_result", "id": "0af5caf6-a8e4-431c-8d0a-4618ae8a2054", "result": "approved", "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b", "created_at": "2023-01-21T22:23:35.432Z", "matched": true, "name": "Approval Policy", "details": { "insight_state": { "name": { "match": true, "status": "verified" }, "address_verification": { "match": true, "status": "verified" } }, "mismatched_rules": [] }, "policy_action_results": [ { "object": "policy_action_result", "id": "936d73d6-aa5c-44bc-86b9-d98b255b16fa", "details": null, "executed": true, "policy_action": { "id": "c232ad85-9a70-4292-baea-575fcb6e4a1d", "action_type": "auto_decision", "options": { "decision": "approve" }, "policy_version_id": "7b1e539f-b622-4615-ba1b-5fd4c1436e0c" } } ] } ], "tin": { "object": "tin", "updated_at": "2023-01-21T06:43:31.201Z", "name": "Middesk Inc. ", "tin": "37-1883180", "mismatch": false, "unknown": false, "verified": true }, "formation": { "object": "formation", "entity_type": "CORPORATION", "formation_date": "2018-03-05", "formation_state": "DE", "created_at": "2023-01-30T23:49:01.164Z", "updated_at": "2023-01-30T23:49:01.217Z" }, "website": { "object": "website", "domain": { "domain": "middesk.com", "creation_date": "2018-11-20T07:02:53.000Z", "expiration_date": "2019-11-20T07:02:53.000Z", "registrar": {} }, "pages": [ { "category": "home", "url": "https://www.middesk.com/" } ], "entities": [ { "text": "Middesk" } ], "parked": false }, "watchlist": { "object": "watchlist", "lists": [ { "title": "Denied Persons List (DPL) - Bureau of Industry and Security", "results": [], "source_last_updated": "2019-01-03T18:03:07.761+00:00" } ] }, "review": { "object": "review", "id": "0eb9094c-33fc-49eb-b5a5-18101d948857", "created_at": "2020-03-06 19:20:29 UTC", "updated_at": "2020-03-06 19:23:24 UTC", "completed_at": "2020-03-06 19:23:24 UTC", "tasks": [ { "category": "tin", "key": "tin", "label": "TIN Match", "message": "The IRS does not have a record for the submitted TIN and Business Name combination", "status": "failure", "sub_label": "Not Found" }, { "category": "name", "key": "name", "label": "Business Name", "message": "Match identified to the submitted Business Name", "status": "success", "sub_label": "Verified" }, { "category": "watchlist", "key": "watchlist", "label": "Watchlist", "message": "No Watchlist hits were identified", "status": "success", "sub_label": "No Hits" } ] }, "registrations": [ { "object": "registration", "id": "53a101f2-d671-4c0a-89b6-6c069e5a3857", "name": "MIDDESK, INC.", "status": "active", "status_details": null, "sub_status": null, "jurisdiction": "FOREIGN", "jurisdiction_details": null, "entity_type": "CORPORATION", "file_number": "C4221590", "country_code": "US", "addresses": [ "2180 BRYANT ST UNIT 210 SAN FRANCISCO CA 94110" ], "registration_date": "2018-12-21", "state": "CA", "source": "https://businesssearch.sos.ca.gov/CBS", "submitted": false }, { "object": "registration", "id": "53a101f2-d671-4c0a-89b6-6c069e5a3864", "name": "MIDDESK, INC.", "status": "active", "status_details": null, "sub_status": null, "jurisdiction": "DOMESTIC", "jurisdiction_details": null, "entity_type": "CORPORATION", "file_number": "6782397", "country_code": "US", "registration_date": "2018-03-05", "state": "DE", "source": "https://icis.corp.delaware.gov", "submitted": false }, { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "name": "MIDDESK, INC.", "status": "active", "status_details": null, "sub_status": "GOOD_STANDING", "jurisdiction": "HOME", "jurisdiction_details": { "name": "Alberta", "abbr": "AB" }, "entity_type": "CORPORATION", "file_number": "123", "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "registration_date": "2019-04-12", "state": null, "source": null, "submitted": true } ], "monitor": { "object": "monitor", "id": "2b58c9a9-8279-4e85-bcf9-60dc2a0241cb", "created_at": "2023-01-21T21:05:52.100Z", "event_types": [ { "type": "bankruptcy", "status": "active" } ] } } ``` **`Example JSON response: Business Verification-Qualify`** ```json title="Example JSON response: Business Verification-Qualify" { "object": "business", "id": "ad2b731b-4fe5-403d-90e0-85a8de332ba0", "external_id": null, "name": "Middesk", "created_at": "2023-07-18T22:06:50.720Z", "updated_at": "2023-07-18T22:06:52.503Z", "status": "in_review", "tags": [], "requester": { "id": "55129a1c-5824-4527-bb14-e7ad8db3af5b", "type": "user", "name": "Ziggy Stardust", "requested_at": "2023-07-18T22:06:50.766Z" }, "assignee_id": "55129a1f-5824-4547-bb14-e7ad8de3af5b", "review": { "object": "review", "id": "a1c3f813-53dc-435c-a2f7-89de494c16f0", "created_at": "2023-07-18T22:06:52.483Z", "updated_at": "2023-07-18T22:06:52.712Z", "completed_at": null, "tasks": [ { "category": "name", "key": "name", "label": "Business Name", "message": "Similar match identified to the submitted Business Name", "name": "name", "status": "warning", "sub_label": "Similar Match" }, { "category": "address", "key": "address_verification", "label": "Office Address", "message": "Match identified to the submitted Office Address", "name": "address", "status": "success", "sub_label": "Verified" }, { "category": "sos", "key": "sos_status", "label": "SOS Filings", "message": "At least one SOS filing status is active.", "name": "sos", "status": "success", "sub_label": "Active" }, { "category": "formation", "key": "time_in_business", "label": "Time in Business", "message": "This business was formed between 3 years and 10 years ago.", "name": "formation", "status": "success", "sub_label": "3-10 years" } ], "assignee": { "object": "user", "id": "55129a1c-5824-4527-bb14-e7ad8db3af5b", "name": "Ziggy Stardust", "email": "ziggy@middesk.com", "roles": [ "admin", "member" ], "image_url": "//www.gravatar.com/avatar/6a1a8830f128a136b36395f9e68c5cab?s=64&d=https%3A%2F%2Fapp.middesk.com%2Fimages%2Fdefault-avatar.png", "last_login_at": "2023-07-19T23:36:06.319Z", "settings": { "receives_agent_emails": false } } }, "business_batch_id": null, "names": [ { "object": "name", "id": "575bbdf8-5f18-4dae-9594-e34fe5b56f26", "name": "Middesk", "submitted": true, "type": "legal", "business_id": "ad2b730b-4fe5-40fd-94e0-85a6de332ba0" } ], "addresses": [ { "object": "address", "address_line1": "85 2nd St", "address_line2": null, "city": "San Francisco", "state": "CA", "postal_code": "94105-3459", "full_address": "85 2nd St, San Francisco, CA 94105-3459", "submitted": true, "id": "a85d93f2-3970-4ec7-ae1c-52575316d47f", "latitude": 37.78827, "longitude": -122.39997, "property_type": null, "deliverable": null, "deliverability_analysis": null, "street_view_available": null, "labels": [], "created_at": "2023-07-18T22:06:50.752Z", "updated_at": "2023-07-18T22:06:51.015Z", "registered_agent_name": null, "cmra": null, "business_id": "ad2b730b-4fe5-40fd-94e0-85a6de332ba0" } ], "people": [], "orders": [ { "object": "order", "id": "923f44df-6e71-4506-bd5d-e7d0af0ffd83", "completed_at": "2023-07-18T22:06:52.407Z", "created_at": "2023-07-18T22:06:50.766Z", "product": "business_verification_qualify", "package": "business_verification_qualify", "requester": { "name": "Erica Clark " }, "status": "completed", "subproducts": [], "updated_at": "2023-07-18T22:06:52.409Z" } ], "actions": [], "submitted": { "object": "submitted_attributes", "name": "Middesk", "entity_type": null, "addresses": [ { "full_address": "85 2nd Street, San Francisco, CA, USA" } ], "orders": [ { "product": "business_verification_qualify", "package": "business_verification_qualify", "subproducts": [] } ] } } ``` ## 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. Reusing a `unique_external_id` prevents creating a duplicate business. | no | | name | `string` | The given [name](/verify-business/name-address#verify-business-names) for the company. | yes | | created\_at | `timestamp` | | yes | | updated\_at | `timestamp` | | no | | status | `string` | The current status of the [business lifecycle](/lifecycle-of-business). One of `open`, `pending`, `in_audit`, `in_review`, `approved`, or `rejected`. | yes | | tin | `object` | Information about the [employer identification number](/verify-business/tin). | Guaranteed if TIN provided when creating the business. null if no TIN was provided. | | formation | `object` | Information about the [formation](/reference/formation) of the business. | nullable | | registrations | `object`\[] | List and details of all known [registrations](/reference/registration). | yes, can be an empty array if no registrations found for the business. | | names | `object`\[] | Details about the business [names](/reference/names). | yes | | addresses | `object`\[] | All known [addresses](/reference/address) 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](/create-orders) per product. A full list of a business's orders can be fetched using the [business orders list endpoint](/api-reference/business-verification/orders/list-orders-for-a-business). | yes | | people | `object`\[] | Information about [people](/reference/person). | yes, can be an empty array | | policy\_results | policy\_result\[] | Information about [policy results](/api-reference/business-verification/policy-results/list-policy-results-for-a-business). | yes, can be an empty array | | profiles | `object`\[] | Information about [profile](/reference/profile). | yes, can be an empty array | | documents | `object`\[] | Information about [document](/reference/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](/reference/adverse-media-screening). | nullable | | bankruptcies | `object`\[] | Information about [Bankruptcy](/assess-risk/legal#finding-bankruptcies) | 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](/online-presence/industry-classification). | nullable | | liens | `object`\[] | Information about [Liens](/assess-risk/search-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](/reference/certification) 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](/reference/litigation) records. | yes, can be an empty array | | politically\_exposed\_person\_screening | `object` \| null | Information about [PEP screening](/reference/politically-exposed-persons) results. | nullable | | signal | `object` \| null | The [signal](/reference/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 | Information about the [tax exempt organization](/reference/tax-exempt-organization) record matched to this business, if any. | nullable | | watchlist | `object` | Information about the [watchlist screenings](/reference/watchlist) | null until the business moves to `in_review`, `approved`, or `rejected` | | website | `object` | [Website](/reference/website) information | nullable | > **Get a demo** > > Contact your account manager or [contact sales](https://www.middesk.com/contact-sales) to inquire about access.