Registrations

The registrations endpoint provides information about state registrations for a given company.

The registration object

A registration object represents your company's tax registration in a specific state. It includes the state-assigned tax ID, registered business location, and a history of filing frequency changes. These details affect tax calculations.

Properties

Name
state
Type
string (2-letter)
State code for the registration.
Name
registration
Type
object
Registration details.
＋ Show child properties
Name
location
Type
object
Registered business location.
＋ Show child properties
Name
frequencies
Type
array
Filing frequency history.
＋ Show child properties

Example: registration object

{
  "state": "KS",
  "registration": {
    "taxId": "K100234567",
    "startedAt": "2024-01-01",
    "endedAt": null
  },
  "location": {
    "line1": "120 SW 10TH AVE",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612"
  },
  "frequencies": [
    {
      "code": "M",
      "startedAt": "2024-01-01",
      "endedAt": null
    }
  ]
}

GET/registrations

List company registrations

This endpoint allows you to retrieve a list of your company's tax registrations across all states. Filter by state to get specific registration details.

Query params

Name
companyId
partner-only
Type
string (optional)
The unique Zamp identifier for a given company. This parameter is reserved for Zamp partners.
Name
state
Type
string (optional, 2-letter)
Filter registrations by state code.

Request

GET

/registrations

curl -G https://api.zamp.com/registrations \
  -H "Authorization: Bearer {token}" \
  -d state=KS

Response

[
  {
    "state": "KS",
    "registration": {
      // ...
    },
    "location": {
      // ...
    },
    "frequencies": [
      // ...
    ]
  }
]