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
/registrationscurl -G https://api.zamp.com/registrations \
-H "Authorization: Bearer {token}" \
-d state=KS
Response
[
{
"state": "KS",
"registration": {
// ...
},
"location": {
// ...
},
"frequencies": [
// ...
]
}
]