Business

Business objects allow you to perform verification and due diligence of companies.

There are many pieces of information that Middesk surfaces about each business including the following:

PropertyTypeDescription
objectstringA definition of the type of object returned
idstring
external_idstringIdentifier from non-Middesk system
unique_external_idstringUnique identifier from 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
namestringThe given name for the company
created_attimestamp
updated_attimestamp
statusstringThe current status of the business lifecycle.
tinobjectInformation about the employer identification number
formationobject[]Information about the formation of the business
registrationsobject[]List and details of all known registrations
namesobject[]Details about the business names
addressesobject[]All known addresses tied to a business entity.
reviewobjectThe business Review.
ordersobject[]The Orders 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.
peopleobject[]Information about people
policy_resultspolicy_result[]Information about policy results
profilesobject[]Information about profile
documentsobject[]Information about Document
supported_document_typesstring[]Only present if Document Retrieval is enabled for the account. This will specify the document types available for retrieval for this particular Business. The valid values are Articles of Incorporation and Certificate of Good Standing.
monitorobjectThe Monitor on this Business, if present
adverse_media_screeningobjectInformation about Adverse Media
bankruptciesobject[]Information about Bankruptcy
phone_numbersobject[]Information about Phone Number
industry_classificationobjectInformation about Industry Classification
liensobject[]Information about Liens
tagsstring[]Custom tags that can be added to a Business at creation for analytics, tracking, and various other use cases.
watchlistobjectInformation about the watchlist screenings
websiteobjectWebsite information
{
  "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",
      "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",
      "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",
      "entity_type": "CORPORATION",
      "file_number": "C4221590",
      "addresses": [
        "2180 BRYANT ST UNIT 210 SAN FRANCISCO CA 94110"
      ],
      "registration_date": "2018-12-21",
      "state": "CA",
      "source": "https://businesssearch.sos.ca.gov/CBS"
    },
    {
      "object": "registration",
      "id": "53a101f2-d671-4c0a-89b6-6c069e5a3864",
      "name": "MIDDESK, INC.",
      "status": "active",
      "status_details": null,
      "sub_status": null,
      "jurisdiction": "DOMESTIC",
      "entity_type": "CORPORATION",
      "file_number": "6782397",
      "registration_date": "2018-03-05",
      "state": "DE",
      "source": "https://icis.corp.delaware.gov"
    }
  ],
  "monitor": {
    "object": "monitor",
    "id": "2b58c9a9-8279-4e85-bcf9-60dc2a0241cb",
    "created_at": "2023-01-21T21:05:52.100Z",
    "event_types": [
      {
        "type": "bankruptcy",
        "status": "active"
      }
    ]
  }
}
{
    "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": "[email protected]",
            "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": [
            {
                "package": "business_verification_qualify",
                "subproducts": []
            }
        ]
    }
}