Skip to main content
GET
/
v1
/
compliance
/
obligations
curl "https://api.vouchmark.com/v1/compliance/obligations?companyId=cmp_aBcD..." \
  -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 compliance obligations (filing deadlines, tax returns, regulatory renewals) tracked for your company.

​
Query parameters

​
companyId
string
Filter obligations to a single company. Omit to return obligations across all companies you can access.
curl "https://api.vouchmark.com/v1/compliance/obligations?companyId=cmp_aBcD..." \
  -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"
    }
  ]
}

​
Obligation object

Every compliance endpoint returns obligations in this shape.
FieldTypeDescription
idstringObligation identifier.
companyIdstringOwning company.
categorystringOne of cac_annual_return, vat, cit, paye, pension, itf, custom.
titlestringObligation name.
descriptionstring | nullOptional detail. May be null.
frequencystringOne of monthly, annual, one_off, custom.
nextDueDatestringNext due date as a YYYY-MM-DD date string (not an ISO datetime).
lastCompletedAtstring | nullISO datetime of last completion, or null.
isSeededbooleantrue if auto-seeded, false if user created.
isActivebooleanWhether the obligation is being tracked.
notifyLeadDaysinteger[]Reminder lead times in days before the due date.
daysUntilDueintegerDays remaining until nextDueDate.
createdAtstringISO creation timestamp.
updatedAtstringISO last-update timestamp.