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": [
      // ...
    ]
  }
]

Was this page helpful?