> 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.

# Registration object

> Lists the contents of a registration record.

Many businesses register to operate in multiple states. For every state that a business is registered in, Middesk returns a registration record.
This page describes the contents of those records.

**`Example JSON response`**

```json title="Example JSON response"
{
  "object": "registration",
  "id": "2d780017-23d2-485c-a1c2-073524851747",
  "business_id": "6fa5f1bd-afc8-49e4-985e-77cb2f0c28c1",
  "name": "MIDDESK, INC.",
  "status": "unknown",
  "sub_status": null,
  "status_details": null,
  "jurisdiction": "DOMESTIC",
  "entity_type": "CORPORATION",
  "file_number": "6782397",
  "addresses": [
    "2035 SUNSET LAKE RD, NEWARK, DE 19702"
  ],
  "officers": [],
  "registered_agent": {
    "name": "JOHN DOE"
  },
  "registration_date": "2018-03-05",
  "state": "DE",
  "source": "https://icis.corp.delaware.gov/Ecorp/EntitySearch/NameSearch.aspx"
}
```

## Registration attributes

| Attribute              | Type          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`               | string        | The object type. Always `registration`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `id`                   | string (uuid) | The unique identifier for the registration record.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `business_id`          | string (uuid) | The unique identifier of the associated business.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `name`                 | string        | The name that is registered with the Secretary of State in that state                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `status`               | string        | The current filing status of that business in that state. These are high-level status categories set by Middesk based on the SoS data, possible values are:- `active`: The business license is active and in good standing in that state
- `inactive`:  The business license is inactive in that state
- `unknown`:  The state does not provide business license status                                                                                                                                                                         |
| `sub_status`           | string        | If available, the normalized sub-status of the business if the state doesn't use the standard SoS statuses, possible values are:- `DISSOLVED`: The company no longer exists
- `GOOD_STANDING`: In good standing, explicitly stated by agency
- `NOT_GOOD_STANDING`: Missing payments or filings from the business, other poor behavior
- `PENDING_ACTIVE`: In the process of becoming truly active
- `PENDING_INACTIVE`: Businesses that are currently active, but are pending an inactive status
- `null`: No sub-status provided by the state |
| `status_details`       | string        | If available, the official filing status message provided by the state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `entity_type`          | string        | The type of entity as detailed in formation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `file_number`          | string        | The unique identifier for that business with the state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `addresses`            | string\[]     | An array containing a list of the addresses that are filed with the state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `jurisdiction`         | string        | Indicates the relationship between the business and this jurisdiction. `DOMESTIC` or `FOREIGN` for US registrations; `HOME` or `EXTRA_PROVINCIAL` for Canada; `UNKNOWN` when undetermined; `null` for other international registrations.                                                                                                                                                                                                                                                                                                        |
| `jurisdiction_details` | object        | The sub-national jurisdiction `name` and `abbr` for international registrations. `null` for US registrations.                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `officers`             | object\[]     | A nested object containing the details of each officer or agent mentioned on a given registration record.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `officers.name`        | string        | The full name of the officer or agent that is listed as associated with the entity.                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `officers.roles`       | string        | The known title of the officer or agent associated with the entity.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `registered_agent`     | object        | The full name of the registered agent associated with the entity.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `registration_date`    | string        | The date that this business registered with the specific state for operation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `country_code`         | string        | `US` for domestic registrations, or an ISO 3166-1 alpha-2 code for international registrations (e.g., `FR`, `DE`, `GB`).                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `state`                | string        | The US state for the registration. `null` for international registrations.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `source`               | string        | A link to the Secretary of State website for that specific state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `submitted`            | boolean       | `true` if you submitted the registration, `false` if Middesk sourced it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

> **Get a demo**
>
> Contact your account manager or [contact sales](https://www.middesk.com/contact-sales) to inquire about access.