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

# List obligations

> Retrieve compliance obligations tracked for a company.

Returns the compliance obligations (filing deadlines, tax returns, regulatory renewals) tracked for your company.

## Query parameters

<ParamField query="companyId" type="string">
  Filter obligations to a single company. Omit to return obligations across all companies you can access.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.vouchmark.com/v1/compliance/obligations?companyId=cmp_aBcD..." \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "obl_aBcD...",
        "companyId": "cmp_aBcD...",
        "category": "vat",
        "title": "VAT filing",
        "description": "Monthly VAT return filed with FIRS by the 21st.",
        "frequency": "monthly",
        "nextDueDate": "2026-07-21",
        "lastCompletedAt": null,
        "isSeeded": true,
        "isActive": true,
        "notifyLeadDays": [30, 7, 1],
        "daysUntilDue": 24,
        "createdAt": "2026-06-01T09:00:00Z",
        "updatedAt": "2026-06-01T09:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>

## Obligation object

Every compliance endpoint returns obligations in this shape.

| Field             | Type           | Description                                                                   |
| ----------------- | -------------- | ----------------------------------------------------------------------------- |
| `id`              | string         | Obligation identifier.                                                        |
| `companyId`       | string         | Owning company.                                                               |
| `category`        | string         | One of `cac_annual_return`, `vat`, `cit`, `paye`, `pension`, `itf`, `custom`. |
| `title`           | string         | Obligation name.                                                              |
| `description`     | string \| null | Optional detail. May be `null`.                                               |
| `frequency`       | string         | One of `monthly`, `annual`, `one_off`, `custom`.                              |
| `nextDueDate`     | string         | Next due date as a `YYYY-MM-DD` date string (not an ISO datetime).            |
| `lastCompletedAt` | string \| null | ISO datetime of last completion, or `null`.                                   |
| `isSeeded`        | boolean        | `true` if auto-seeded, `false` if user created.                               |
| `isActive`        | boolean        | Whether the obligation is being tracked.                                      |
| `notifyLeadDays`  | integer\[]     | Reminder lead times in days before the due date.                              |
| `daysUntilDue`    | integer        | Days remaining until `nextDueDate`.                                           |
| `createdAt`       | string         | ISO creation timestamp.                                                       |
| `updatedAt`       | string         | ISO last-update timestamp.                                                    |