> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.middesk.com/reference/registration/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. > Lists the contents of a registration record.