Skip to main content
GET
/
v1
/
compliance
/
obligations
/
upcoming
curl "https://api.vouchmark.com/v1/compliance/obligations/upcoming?companyId=cmp_aBcD...&limit=5" \
  -H "Authorization: Bearer $TOKEN"

{
  "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"
    }
  ]
}
Returns the soonest-due obligations for a company, ordered by due date. Useful for building reminders or a “what’s next” widget.

​
Query parameters

​
companyId
string
required
The company to list upcoming obligations for.
​
limit
integer
default:"3"
How many obligations to return. Integer between 1 and 50.
curl "https://api.vouchmark.com/v1/compliance/obligations/upcoming?companyId=cmp_aBcD...&limit=5" \
  -H "Authorization: Bearer $TOKEN"

{
  "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"
    }
  ]
}
Each item is a full obligation object.