Registrations

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

The Registration Object

Property	Type	Description
`state`	string (2-letter)	State code for the registration
`registration.taxId`	string	State-assigned tax identification number
`registration.startedAt`	date (ISO 8601)	Date registration became effective
`registration.endedAt`	date (optional)	Date registration ended, if applicable
`location.line1`	string	First line of business address
`location.line2`	string (optional)	Second line of business address
`location.city`	string	City name
`location.state`	string (2-letter)	State code
`location.zip`	string	ZIP or postal code
`frequencies[].code`	string	Frequency code
`frequencies[].startedAt`	date	Date frequency became effective
`frequencies[].endedAt`	date (optional)	Date frequency ended

Frequency Codes

A (Annual), M (Monthly), MDFA, MP, NYA, NYQ, NYQP, Q (Quarterly), QP, SA (Semi-Annual)

Example

{
  "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
    }
  ]
}

List Company Registrations

companyId

string

The unique Zamp identifier for a given company. Reserved for Zamp partners.

state

string

Filter registrations by 2-letter state code.

Request

GET /registrations

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

Response

200

[
  {
    "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
      }
    ]
  }
]

​The Registration Object

​Frequency Codes

​Example

​List Company Registrations

​Request

​Response