Names object | Middesk

A business can go by one or multiple names. This page describes the names array object, which contains all the known names associated with a business and the sources (like state registrations or websites) where each name was found.

Example JSON response

1 "names": [
2   {
3     "name": "MIDDESK INC",
4     "sources": [
5       {
6         "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
7         "type": "registration",
8         "metadata": {
9           "file_number": "C4221590",
10           "state": "CA"
11         }
12       },
13       {
14         "id": "02c1dcb2-6405-478b-9b94-78c7cbea99",
15         "type": "website",
16         "metadata": {
17           "url": "https://www.middesk.com"
18         }
19       }
20     ]
21   },
22   {
23     "name": "MIDDESK",
24     "sources": {
25       "id": "w026445j-5ofb-2401-527b-27a6d84pw947",
26       "type": "registration",
27       "metadata": {
28         "file_number": "DE5267854",
29         "state": "DE"
30       }
31     }
32   }
33 ]

Name attributes

Attribute	Type	Description
`object`	string	The object type. Always `name`.
`id`	string (uuid)	The unique identifier for the name record.
`name`	string	The known names that are tied to the business you are verifying
`submitted`	boolean	Whether the name was submitted by the user (`true`) or discovered by Middesk (`false`).
`type`	string \| null	The type of name. Possible values: `legal`, `dba`.
`business_id`	string (uuid)	The ID of the business this name belongs to.
`sources`	object[]	An array of source objects containing information about where this name is found
`sources[].id`	string	Id of the source object
`sources[].type`	string	The type of the source object
`sources[].metadata`	object	Additional metadata to identify the source object

Get a demo

Contact your account manager or contact sales to inquire about access.