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"
}
]
}
Compliance
List obligations
Retrieve compliance obligations tracked for a company.
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
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.| 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. |
⌘I