Retrieve a registration request

import requests
url = "https://api.middesk.com/v1/partner/registration_requests/id"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "object": "registration_request",
  "id": "153b6874-992f-4dea-a6ff-12c142fcd865",
  "state": "CO",
  "status": "pending",
  "tax_registration_types": [
    "state_unemployment_insurance",
    "state_tax_withholdings"
  ],
  "company_id": "1432d966-edd3-4245-863a-a114aa6f2140",
  "created_at": "2025-12-26T21:48:24Z",
  "agencies": [
    {
      "key": "value"
    }
  ],
  "items": [
    {
      "key": "value"
    }
  ],
  "invite_link": "https://agent.middesk.com/invitations?guest_token=698095f6434310507d7d4aeb2b559879",
  "external_id": "external"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Registration Request ID

Response

registration request found

objectstring

idstringformat: "uuid"

stateenum

US state abbreviation

statusstring

Request status

tax_registration_typeslist of strings or null

Types of tax registrations requested

company_idstringformat: "uuid"

created_atstring

agencieslist of maps from strings to any

Tax agency registrations

itemslist of maps from strings to any

Registration items

invite_linkstringformat: "uri"

external_idstring or null

submitted_atstring or null

tax_registrationmap from strings to any or null

Tax registration details

Authentication

Path parameters

Response

Errors