> ## Documentation Index
> Fetch the complete documentation index at: https://developer.zamp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Filings

> Access tax filing history and documents.

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

```json theme={null}
{
  "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

<ParamField query="companyId" type="string">
  The unique Zamp identifier for a given company. Reserved for Zamp partners.
</ParamField>

<ParamField query="state" type="string">
  Filter filings by 2-letter state code.
</ParamField>

<ParamField query="minDueOn" type="date">
  Filter filings due on or after this date.
</ParamField>

<ParamField query="maxDueOn" type="date">
  Filter filings due on or before this date.
</ParamField>

<ParamField query="isCompleted" type="boolean">
  Filter by completion status.
</ParamField>

<ParamField query="cursor" type="string">
  Cursor from previous response for pagination. `null` indicates no more pages.
</ParamField>

### Request

```bash GET /filings theme={null}
curl https://api.zamp.com/filings \
  -H "Authorization: Bearer {token}" \
  -d state=KS \
  -d minDueOn=2025-02-01 \
  -d maxDueOn=2025-02-28
```

### Response

```json 200 theme={null}
{
  "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": []
    }
  ]
}
```