API Reference
Statutory Deadlines
Retrieve Nigerian tax filing calendars, monthly remittance due dates, and agency rules.
Statutory Deadlines
GET /api/v1/tax/deadlines | POST /api/v1/tax/deadlines
Returns the official statutory compliance calendar, filing due dates, and remittance deadlines across Federal (FIRS) and State Internal Revenue Services (such as LIRS, OGIRS, KIRS).
Required scope: tax:deadlines.
Query Parameters (GET) / Request Body (POST)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tax_type | string | No | All | Filter by specific tax: "paye", "cit", "vat", "wht". Alias: filter_tax_type. |
as_of | string | No | Today | Calculation reference date in YYYY-MM-DD format. |
Code Examples
curl -X GET "https://taxnigeria.ng/api/v1/tax/deadlines?tax_type=paye" \
-H "Authorization: Bearer txn_your_api_key_here"Response Example (200 OK)
{
"ok": true,
"data": [
{
"tax_type": "paye",
"title": "PAYE Monthly Remittance",
"description": "Monthly remittance of Personal Income Tax deducted from employees.",
"authority": "State Internal Revenue Service (SIRS / LIRS)",
"due_day": 10,
"frequency": "monthly",
"next_deadline": "2026-11-10",
"days_remaining": 13,
"penalty_note": "10% statutory penalty per annum plus commercial interest at CBN MPR + 5%."
},
{
"tax_type": "vat",
"title": "VAT Monthly Filing & Remittance",
"description": "Filing of Value Added Tax returns on FIRS TaxPro Max portal.",
"authority": "Federal Inland Revenue Service (FIRS)",
"due_day": 21,
"frequency": "monthly",
"next_deadline": "2026-11-21",
"days_remaining": 24,
"penalty_note": "₦50,000 for the first month and ₦25,000 for each subsequent month."
}
],
"meta": {
"timestamp": "2026-10-28T13:35:00.000Z",
"latency_ms": 7
}
}