Prefill business information

import requests
url = "https://api.middesk.com/v1/prefill/businesses"
payload = {
    "names": ["Example Company Inc."],
    "addresses": ["123 Main St, San Francisco, CA 94105"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "object": "business",
  "names": [
    {
      "name": "Example Company Inc.",
      "type": "legal"
    }
  ],
  "addresses": [
    {
      "full_address": "123 Main St, San Francisco, CA 94105",
      "address_line1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105",
      "labels": [
        "labels"
      ]
    }
  ],
  "formation": {
    "entity_type": "CORPORATION"
  },
  "people": [
    {
      "name": "Michael Scott",
      "titles": [
        "titles"
      ]
    }
  ]
}

Smart populate business attributes by searching with name and address, TIN, or website URL. Returns enriched business data.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

nameslist of stringsOptional

Business name(s) to search for

addresseslist of stringsOptional

Business address(es) to search for

tinstringOptional

Taxpayer Identification Number

website_urlstringOptional

Business website URL

Response

prefill results

objectstring or null

nameslist of objects or null

Business names

addresseslist of objects or null

Business addresses

tinobject or null

TIN information if verified

formationobject or null

Formation details

industry_classificationslist of objects or null

Industry classifications

peoplelist of objects or null

Associated persons

websiteobject or null

Website information

Authentication

Request

Response

Errors