RegistrationRequest object

This page describes the registration_request object, which represents a request to register a business for tax purposes in a specific state.

Example JSON response

1 {
2   "object": "registration_request",
3   "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
4   "state": "CA",
5   "status": "in_progress",
6   "tax_registration_types": ["sales_tax", "payroll_tax"],
7   "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8   "external_id": "ext-reg-12345",
9   "submitted_at": "2024-01-15T09:30:00Z",
10   "created_at": "2024-01-10T14:00:00Z",
11   "agencies": [
12     {
13       "name": "California Department of Tax and Fee Administration",
14       "status": "pending",
15       "registration_number": null
16     }
17   ],
18   "items": [
19     {
20       "type": "sales_tax",
21       "status": "in_progress"
22     }
23   ],
24   "tax_registration": {
25     "sales_tax_id": null,
26     "payroll_tax_id": null
27   },
28   "invite_link": "https://app.middesk.com/register/d290f1ee-6c54-4b01-90e6-d701748f0851"
29 }

RegistrationRequest attributes

Attribute	Type	Description
`object`	string	Object type identifier. Always `registration_request`.
`id`	string (uuid)	Unique identifier for the registration request.
`state`	string	US state abbreviation where registration is being requested.
`status`	string	Current status of the registration request.
`tax_registration_types`	array[string]	Types of tax registrations requested (for example, `sales_tax`, `payroll_tax`).
`company_id`	string (uuid)	ID of the company being registered.
`external_id`	string \| null	External identifier for the registration request in your system.
`submitted_at`	timestamp \| null	When the registration was submitted to the state.
`created_at`	timestamp	When the registration request was created.
`agencies`	array[object]	Tax agency registrations and their statuses.
`items`	array[object]	Individual registration items and their statuses.
`tax_registration`	object \| null	Tax registration details including assigned IDs.
`invite_link`	string (uri)	URL to invite users to complete the registration.

State values

The state attribute accepts standard two-letter US state abbreviations:

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

Status values

Common status values for registration requests:

Status	Description
`pending`	Request created but not yet submitted.
`in_progress`	Registration is being processed by the state.
`completed`	Registration has been successfully completed.
`failed`	Registration failed or was rejected.

Get a demo

Contact your account manager or contact sales to inquire about access.