Name

A business can go by one or multiple names.

"names": [
  {
    "object": "name",
    "id": "a8f87c9d-1c7b-4799-abaa-00b206159d73",
    "name": "Middesk inc",
    "submitted": true,
    "type": "legal",
    "business_id": "721e490b-45b7-4ed0-b466-621044e9aee4",
    "sources": [
      {
        "id": "64c04799-cb33-47d5-a135-48072fc6f3cd",
        "type": "registration",
        "metadata": {
          "state": "DE",
          "status": "unknown",
          "file_number": "000000",
          "jurisdiction": "DOMESTIC"
        }
      },
      {
        "id": "2e845d8d-54f8-45aa-a905-950ba0d2fcf9",
        "type": "registration",
        "metadata": {
          "state": "CA",
          "status": "active",
          "file_number": "111111",
          "jurisdiction": "FOREIGN"
        }
      },
    ]
  },
  {
    "object": "name",
    "id": "a2f0a777-5521-44f6-ad1f-10eeec14b285",
    "name": "Middesk",
    "submitted": true,
    "type": "dba",
    "business_id": "721e490b-45b7-4ed0-b466-621044e9aee4",
    "sources": [
      {
        "id": "ae3903af-88d1-43fa-a11d-ceabce3d7168",
        "type": "profile",
        "metadata": {
          "url": "<https://www.facebook.com/middesk/>",
          "city": "San Francisco",
          "name": "Middesk",
          "type": "facebook",
          "state": "CA"
        }
      },
      {
        "id": "0a6b253b-7c65-428d-87db-cce841b35c5c",
        "type": "profile",
        "metadata": {
          "url": "<https://maps.google.com/?cid=6720954453079130673>",
          "name": "Middesk, Inc.",
          "type": "google",
          "website": "<http://www.middesk.com/>",
          "latitude": 37.78835029999999,
          "longitude": -122.3997377,
          "categories": [
            "point_of_interest",
            "establishment"
          ],
          "full_address": "85 2nd St, San Francisco, CA 94105, USA"
        }
      }
    ]
  }
]
AttributeTypeDescription
namestringThe known names that are tied to the business you are verifying
name_typestringThe name_type attribute indicates the type of name associated with the business and can have two possible values: "legal" or "dba". "Legal" refers to the entity's legal name, and "DBA" stands for "doing business as" and refers to any other names the business may be operating under. Only the legal name will be used to verify the identity of the business.
submittedbooleanThe submitted attribute indicates whether the name was submitted as part of the report request.
sourcesobject[]An array of source objects containing information about where this name is found
sources[].idstringId of the source object
sources[].typestringThe type of the source object
sources[].metadataobjectAdditional metadata to identify the source object

FMCSA Registrations

🚧

FMCSA Registrations Enablement

As a supplementary data point for business name verification, we have added the ability to search and match against the FMCSA (Federal Motor Carrier Safety Administration). This feature is enabled by default; therefore, the FMCSA will appear in the "source" field for cases where the legal business name can be found through their database (reference the sample JSON response below for the full mapping). Note this is an optional feature that can be turned off by reaching out to your Account Manager or to [email protected]

FMCSA Name Match JSON Response:

{
  ...
  "fmcsa_registrations": [
    {
      "object": "fmcsa_registration",
      "id": "d0a8195f-0480-406b-8406-3ac715b2f89d",
      "dot_number": "1762382",
      "legal_name": "ACME SALES INC",
      "dba_name": null,
      "source": "<link>",
      "addresses": [
        "321 Acme St, Rio Rico, AZ 85648-6236"
      ]
    }
  ],
  "names": [
    {
      "object": "name",
      "id": "16bbea52-dbbe-476e-be1c-6b58d1cc3cdd",
      "name": "Acme Sales, Inc.",
      "submitted": true,
      "type": "legal",
      "business_id": "452800b5-73df-4ca4-b58e-443469ec1c3d",
      "sources": [
        {
          "id": "d0a8195f-0480-406b-8406-3ac715b2f89d",
          "type": "fmcsa_registration",
          "metadata": {
            "dot_number": "1762382"
          }
        }
      ]
    }
  ]
  ...
}