For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Get started
    • Quickstart—Verify a Business
    • Quickstart—Register an entity for payroll taxes
    • Learn how Middesk works
    • Security
    • Changelog
  • Build with Middesk
    • Get your API keys
    • Understand API changes
    • Status codes and errors reference
    • Implement webhooks
    • Secure webhooks
    • Use GraphQL
    • Connect MCP
  • Verify a business (KYB)
    • Verify TIN
    • Verify name and address
    • Verify Secretary of State status
    • Verify owners and officers
    • Screen for sanctions and watchlists
    • Search for adverse media
    • Search for Politically Exposed Persons
    • Implement KYC
    • Discover connections
    • Evaluate online presence
    • Assess credit risk
    • Accelerate onboarding
    • Monitor business activity
    • Manage business entities
      • Learn the registration lifecycle
      • Register an entity for payroll taxes
      • Configure webhooks for entity management
        • Invite employers
        • Registration items labels and keys
        • Optional parameters for registration requests
        • Tax registration items
        • Jurisdiction registration status
        • Partner integration endpoints
        • Sandbox guide
    • Work with agents
LogoLogo
Contact SalesGet Support
On this page
  • Tax registration item attributes
Manage business entitiesReferences

Tax registration items

Was this page helpful?
Previous

Jurisdiction registration status

Next
Built with

Tax Registration Items (items in a Jurisdiction Registration) correspond to the individual tax ID numbers and rates for each registration. A single jurisdiction registration typically contains multiple items — for example, a state withholding registration may produce both a withholding account number (a tax ID) and a withholding rate (a tax rate), each represented as its own item.

Items appear on a registration once the jurisdiction issues the underlying credentials. Until then, the registration may be present without items, or items may be present with pending status while Middesk waits on agency response. The value field holds either the assigned account number (for tax ID items) or the assigned rate (for tax rate items), and status reflects whether the item is active, pending, or closed.

View the list of Registration Items for all possible key and label values per jurisdiction. Use this reference to understand how Middesk structures tax-related data in API responses and webhook payloads.

Tax registration item attributes

PropertyTypeDescription
objectstringA definition of the type of object returned.
idstring
keystringThe item’s key.
labelstringThe item’s label.
agencystringThe item’s agency.
valuestringThe value of the Tax ID or Rate.
statusstatusThe status of each individual item.
Get a demo
Contact your account manager or contact sales to inquire about access.