Filings

The Filings endpoint provides information about a company’s tax filing history.

The Filing Object

Property	Type	Description
`state`	string (2-letter)	State code for the filing
`period.code`	string	Period code (e.g., `2024-Q3`)
`period.name`	string	Human-readable period name (e.g., `Q3 2024`)
`frequency.code`	string	Frequency code (A, M, MDFA, MP, NYA, NYQ, NYQP, Q, QP, SA)
`frequency.name`	string	Human-readable frequency name
`dueOn`	date (ISO 8601)	State-specified due date for the filing
`isCompleted`	boolean	Whether the filing has been completed
`estimatedTaxDue`	number	Estimated tax amount due for this filing
`artifacts`	array	Filing artifacts and documents

Artifact Properties

Property	Type	Description
`returnConfirmation`	string	State confirmation number for the return
`paymentConfirmation`	string (optional)	State confirmation number for the payment
`amountPaid`	number (optional)	Amount paid with this filing
`files[].type`	string	Document type: `FILING_OTHER`, `FILING_PAYMENT`, `FILING_RETURN`, `FILING_RETURN_PAYMENT`, `FILING_TEMPLATE`
`files[].signedUrl`	string	Signed URL to download the file (expires after 1 hour)

Example

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

string

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

string

Filter filings by 2-letter state code.

date

Filter filings due on or after this date.

date

Filter filings due on or before this date.

boolean

Filter by completion status.

string

Cursor from previous response for pagination. null 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

200

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

Home

Core Concepts

Workflow Playbooks

API Reference

Integrations

The Filing Object

Artifact Properties

Example

List All Filings

Request

Response

​The Filing Object

​Artifact Properties

​Example

​List All Filings

​Request

​Response

The Filing Object

Artifact Properties

Example

List All Filings

Request

Response