Skip to main content
POST
/
v1
/
compliance
/
obligations
curl -X POST https://api.vouchmark.com/v1/compliance/obligations \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "cmp_aBcD...",
    "category": "vat",
    "title": "VAT filing",
    "description": "Monthly VAT return filed with FIRS by the 21st.",
    "frequency": "monthly",
    "nextDueDate": "2026-07-21",
    "notifyLeadDays": [30, 7, 1]
  }'

{
  "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": false,
    "isActive": true,
    "notifyLeadDays": [30, 7, 1],
    "daysUntilDue": 24,
    "createdAt": "2026-06-01T09:00:00Z",
    "updatedAt": "2026-06-01T09:00:00Z"
  }
}
Creates a new compliance obligation. Use this to track regulatory deadlines not covered by the auto-seeded defaults.

​
Body

​
companyId
string
required
The company this obligation belongs to.
​
category
string
required
One of cac_annual_return, vat, cit, paye, pension, itf, custom.
​
title
string
required
Obligation name, 1–160 characters.
​
description
string
Optional detail, up to 1000 characters.
​
frequency
string
required
One of monthly, annual, one_off, custom.
​
nextDueDate
string
required
Next due date as a YYYY-MM-DD date string.
​
notifyLeadDays
integer[]
Reminder lead times in days before the due date. Each value 0–365, up to 8 entries.
curl -X POST https://api.vouchmark.com/v1/compliance/obligations \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "cmp_aBcD...",
    "category": "vat",
    "title": "VAT filing",
    "description": "Monthly VAT return filed with FIRS by the 21st.",
    "frequency": "monthly",
    "nextDueDate": "2026-07-21",
    "notifyLeadDays": [30, 7, 1]
  }'

{
  "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": false,
    "isActive": true,
    "notifyLeadDays": [30, 7, 1],
    "daysUntilDue": 24,
    "createdAt": "2026-06-01T09:00:00Z",
    "updatedAt": "2026-06-01T09:00:00Z"
  }
}
Returns 201 Created with the new obligation object.