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

GET/filings

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 or prevCursor) that's used to load the next page. A null value indicates no more pages.

Request

GET

/filings

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