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

Was this page helpful?