API Reference
AI Tax Law Query
Ask natural language questions about Nigerian tax laws grounded in official gazettes and statutory acts.
AI Tax Law Query
POST /api/v1/tax/query
Performs intelligent, context-grounded retrieval-augmented generation (RAG) across Nigerian tax legislation, FIRS information circulars, and court rulings. Supports multilingual responses (English, Nigerian Pidgin, Yoruba, Hausa, Igbo).
Required scope: tax:query.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
question | string | Yes | — | The tax inquiry or scenario to analyze. Aliases: query, q. |
mode | string | No | "ai_tax_queries" | AI personality mode: "ai_tax_queries", "general", "education". |
language | string | No | "English" | Target response language: "English", "Nigerian Pidgin", "Yoruba", "Hausa", "Igbo". |
include_sources | boolean | No | true | Whether to return cited statutory sections and legal gazette references. |
Code Examples
curl -X POST "https://taxnigeria.ng/api/v1/tax/query" \
-H "Authorization: Bearer txn_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"question": "Are tech startups with less than 50 million naira annual turnover required to pay Companies Income Tax in Nigeria?",
"include_sources": true
}'Response Example (200 OK)
{
"ok": true,
"data": {
"query": "Are tech startups with less than 50 million naira annual turnover required to pay Companies Income Tax in Nigeria?",
"answer": "No. Under the Nigerian Companies Income Tax Act (CITA) as amended by recent Finance Acts, small companies with gross annual turnover below ₦50 Million are taxed at 0% (fully exempt from CIT). Furthermore, they are exempt from Tertiary Education Tax (TET). However, they must still file annual income tax returns with the FIRS.",
"sources": [
{
"title": "Companies Income Tax Act (CITA) Cap C21 LFN 2004",
"section": "Section 23 - Small Company Tax Exemptions",
"relevance_score": 0.94
}
],
"mode": "ai_tax_queries",
"language": "English"
},
"meta": {
"timestamp": "2026-10-28T13:36:00.000Z",
"latency_ms": 680
}
}