Skip to main content
POST
/
v1
/
compliance
/
seed
curl -X POST https://api.vouchmark.com/v1/compliance/seed \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId": "cmp_aBcD..."}'
{
  "success": true,
  "data": {
    "created": [
      {
        "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"
      }
    ],
    "skipped": []
  }
}
Seeds your compliance calendar with the standard Nigerian regulatory obligations (CAC annual return, VAT, CIT, PAYE, pension, ITF). Obligations that already exist for the company are skipped, so this is safe to re-run.

Body

companyId
string
required
The company to seed obligations for.
curl -X POST https://api.vouchmark.com/v1/compliance/seed \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId": "cmp_aBcD..."}'
{
  "success": true,
  "data": {
    "created": [
      {
        "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"
      }
    ],
    "skipped": []
  }
}
Returns 201 Created. created contains the newly inserted obligation objects; skipped lists obligations that already existed and were left untouched.