Filings - Zamp

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

companyId

string

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

state

string

Filter filings by 2-letter state code.

minDueOn

date

Filter filings due on or after this date.

maxDueOn

date

Filter filings due on or before this date.

isCompleted

boolean

Filter by completion status.

cursor

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

​The Filing Object

​Artifact Properties

​Example

​List All Filings

​Request

​Response

The Filing Object

Artifact Properties

Example

List All Filings

Request

Response