API Reference
Tax Gazette Search
Semantic vector search across official Nigerian tax legislation, gazettes, and court circulars.
Tax Gazette Search
POST /api/v1/tax/search
Direct semantic search into Tax Nigeria's high-dimensional vector embeddings of the Personal Income Tax Act (PITA), Companies Income Tax Act (CITA), Value Added Tax Act (VATA), Finance Acts, and FIRS information circulars.
Required scope: tax:search.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search phrase or topic. Aliases: search, q. |
top_k | number | No | 5 | Maximum number of matching passages to return (between 1 and 10). Alias: max_results. |
Code Examples
curl -X POST "https://taxnigeria.ng/api/v1/tax/search" \
-H "Authorization: Bearer txn_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"query": "allowable deductions under consolidated relief allowance",
"top_k": 3
}'Response Example (200 OK)
{
"ok": true,
"data": {
"query": "allowable deductions under consolidated relief allowance",
"total_results": 3,
"spoken_summary": "According to Personal Income Tax Act: There shall be allowed a consolidated relief allowance of ₦200,000 or 1% of gross income, whichever is higher, plus 20% of gross income...",
"results": [
{
"id": "pita_sec_33_reliefs",
"score": 0.892,
"content": "Section 33(1): There shall be allowed a consolidated relief allowance of ₦200,000 subject to a minimum of 1 per cent of gross income, whichever is higher, plus 20 per cent of gross income and the balance shall be taxable.",
"metadata": {
"law_name": "Personal Income Tax Act (PITA)",
"section": "Section 33(1)",
"category": "Reliefs and Allowances"
}
}
]
},
"meta": {
"timestamp": "2026-10-28T13:37:00.000Z",
"latency_ms": 112
}
}