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_idstringUnique identifier from non-Middesk system
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.
websiteobjectWebsite information
watchlistobjectInformation about the watchlist screenings
peopleobject[]Information about people
policy_resultspolicy_result[]Information about policy results
profilesobject[]Information about profile
documentsobject[]Information about Document
subscriptionobjectThe Subscription on this Business, if present
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.
{
  "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"
      }
    ]
  }
}