> ## 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.

# Upcoming obligations

> Get the next obligations coming due for a company.

Returns the soonest-due obligations for a company, ordered by due date. Useful for building reminders or a "what's next" widget.

## Query parameters

<ParamField query="companyId" type="string" required>
  The company to list upcoming obligations for.
</ParamField>

<ParamField query="limit" type="integer" default="3">
  How many obligations to return. Integer between `1` and `50`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.vouchmark.com/v1/compliance/obligations/upcoming?companyId=cmp_aBcD...&limit=5" \
    -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>

Each item is a full [obligation object](/api-reference/compliance/list-obligations#obligation-object).