v5

latestOpenAPI 3.1.02026-08-0679357226.6 KB

registrations

Create a registration for a business

post/v1/businesses/{business_id}/registrations

Path parameters

business_idstring required

Business ID

Headers

Authorizationstring required

Bearer authentication

Request body

file_numberstring required

The registration or file number issued by the international registry.

country_codestring required

ISO 3166-1 alpha-2 country code of the registry (e.g., FR, DE, GB).

Response

registration created

objectstring required

idstring uuid required

business_idstring uuid required

namestring required

statusstring required

sub_statusstring nullable

status_detailsstring nullable

jurisdictionstring nullable required

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.

entity_typestring nullable required

file_numberstring required

country_codestring

US for domestic registrations, or an ISO 3166-1 alpha-2 code for international registrations (e.g., FR, DE, GB).

addressesstring[]

officersobject[]

registered_agentobject nullable

registration_datestring date nullable

state'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' required

The US state for the registration. null for international registrations.

sourcestring uri nullable

submittedboolean

true if you submitted the registration, false if Middesk sourced it.