Registration object

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

1 {
2   "object": "registration",
3   "id": "2d780017-23d2-485c-a1c2-073524851747",
4   "business_id": "6fa5f1bd-afc8-49e4-985e-77cb2f0c28c1",
5   "name": "MIDDESK, INC.",
6   "status": "unknown",
7   "sub_status": null,
8   "status_details": null,
9   "jurisdiction": "DOMESTIC",
10   "entity_type": "CORPORATION",
11   "file_number": "6782397",
12   "addresses": [
13     "2035 SUNSET LAKE RD, NEWARK, DE 19702"
14   ],
15   "officers": [],
16   "registered_agent": {
17     "name": "JOHN DOE"
18   },
19   "registration_date": "2018-03-05",
20   "state": "DE",
21   "source": "https://icis.corp.delaware.gov/Ecorp/EntitySearch/NameSearch.aspx"
22 }

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 to inquire about access.