> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.middesk.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server.

# Names object

> Lists the contents of the names object.

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`**

```json title="Example JSON response"
"names": [
  {
    "name": "MIDDESK INC",
    "sources": [
      {
        "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
        "type": "registration",
        "metadata": {
          "file_number": "C4221590",
          "state": "CA"
        }
      },
      {
        "id": "02c1dcb2-6405-478b-9b94-78c7cbea99",
        "type": "website",
        "metadata": {
          "url": "https://www.middesk.com"
        }
      }
    ]
  },
  {
    "name": "MIDDESK",
    "sources": {
      "id": "w026445j-5ofb-2401-527b-27a6d84pw947",
      "type": "registration",
      "metadata": {
        "file_number": "DE5267854",
        "state": "DE"
      }
    }
  }
]
```

## 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](https://www.middesk.com/contact-sales) to inquire about access.