Seed obligations

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": []
  }
}

POST

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

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.

Overview

Auth

Companies

Verifications

Onboarding (KYB)

Widget Embed (Runtime)

Trust Badge

Monitoring

Investigations

Disputes

Vouch AI

Compliance

Wallet & Billing

Developers

Body

​Body

Body