Filings
The Filings endpoint provides information about a company's tax filing history.
The filing object
A filing object contains details about a given tax filing event.
Properties
- Name
state
- Type
- string (2-letter)
State code for the filing.
- Name
period
- Type
- object
Filing period information.
+ Show child properties - Name
frequency
- Type
- object
Filing frequency information.
+ Show child properties - Name
dueOn
- Type
- date (ISO 8601)
State-specified due date for the filing.
- Name
isCompleted
- Type
- boolean
Whether the filing has been completed.
- Name
estimatedTaxDue
- Type
- number
Estimated tax amount due for this filing.
- Name
artifacts
- Type
- array
Filing artifacts and documents.
+ Show child properties
Example: filing object
{
"state": "KS",
"period": {
"code": "2025-JAN",
"name": "January 2025"
},
"frequency": {
"code": "M",
"name": "Monthly"
},
"dueOn": "2025-02-25",
"isCompleted": true,
"estimatedTaxDue": 25.25,
"artifacts": [
{
"returnConfirmation": "7291-QXMF-8K63",
"paymentConfirmation": "7291-QXMF-8K63",
"amountPaid": 25.25,
"files": [
{
"type": "FILING_RETURN",
"signedUrl": "<URL>"
}
{
"type": "FILING_PAYMENT",
"signedUrl": "<URL>"
}
]
}
]
}
List all filings
This endpoint allows you to retrieve a paginated list of filing records for your company. Filter by state, date range, or completion status to find specific filings.
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 (2-letter) (optional)
Filter filings by state code.
- Name
minDueOn
- Type
- date (ISO 8601) (optional)
Filter filings due on or after this date.
- Name
maxDueOn
- Type
- date (ISO 8601) (optional)
Filter filings due on or before this date.
- Name
isCompleted
- Type
- boolean (optional)
Filter by completion status.
- Name
cursor
- Type
- string (optional)
Cursor returned from a previous response (
nextCursor
orprevCursor
) that's used to load the next page. Anull
value indicates no more pages.
Request
curl https://api.zamp.com/filings \
-H "Authorization: Bearer {token}" \
-d state=KS \
-d minDueOn=2025-02-01 \
-d maxDueOn=2025-02-28
Response
{
"prevCursor": null,
"nextCursor": null,
"data": [
{
"state": "KS",
"period": {
"code": "2025-JAN",
"name": "January 2025"
},
"frequency": {
"code": "M",
"name": "Monthly"
},
"dueOn": "2025-02-25",
"isCompleted": true,
"estimatedTaxDue": 25.25,
"artifacts": [
// ...
]
}
]
}