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:
Property | Type | Description |
---|---|---|
object | string | A definition of the type of object returned |
id | string | |
external_id | string | Unique identifier from non-Middesk system |
name | string | The given name for the company |
created_at | timestamp | |
updated_at | timestamp | |
status | string | The current status of the business lifecycle. |
tin | object | Information about the employer identification number |
formation | object[] | Information about the formation of the business |
registrations | object[] | List and details of all known registrations |
names | object[] | Details about the business names |
addresses | object[] | All known addresses tied to a business entity. |
review | object | The business Review. |
website | object | Website information |
watchlist | object | Information about the watchlist screenings |
people | object[] | Information about people |
policy_results | policy_result[] | Information about policy results |
profiles | object[] | Information about profile |
documents | object[] | Information about Document |
subscription | object | The Subscription on this Business, if present |
bankruptcies | object[] | Information about Bankruptcy |
phone_numbers | object[] | Information about Phone Number |
industry_classification | object | Information about Industry Classification |
liens | object[] | Information about Liens |
tags | string[] | Custom tags that can be added to a Business at creation for analytics, tracking, and various other use cases. |
{
"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"
}
],
"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_enabled": true,
"type_of": "AUTO_APPROVAL"
},
],
"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"
}
],
"subscription": {
"object": "subscription",
"id": "2b58c9a9-8279-4e85-bcf9-60dc2a0241cb",
"created_at": "2023-01-21T21:05:52.100Z",
"event_types": [
{
"type": "bankruptcy.created",
"status": "active"
}
]
}
}