Partner API Overview
Complete RESTful API documentation for automated Nigerian tax calculation, compliance deadlines, and AI intelligence.
Partner API Reference
The Tax Nigeria Partner API gives fintech platforms, HR & payroll systems, ERP software, and tax advisors programmatic access to statutory tax calculations and legal intelligence under Nigerian tax laws.
Base URLs
| Environment | Base URL |
|---|---|
| Production | https://taxnigeria.ng/api/v1 |
| Local Sandbox | http://localhost:3000/api/v1 |
OpenAPI Specification
Tax Nigeria publishes a live OpenAPI 3.1 specification. You can import it directly into Postman, Insomnia, or Swagger Editor:
- OpenAPI 3.1 JSON:
/api/v1/openapi.json
Available Endpoints
Unified Tax Engine
Calculate PAYE, CIT, WHT, or late-filing penalties in a single unified endpoint.
PAYE Calculator
Personal income tax, statutory CRA relief, and progressive tax brackets.
Company Income Tax (CIT)
Corporate tax rates (0%, 20%, 30%), small business exemptions, and TET.
Withholding Tax (WHT)
Statutory WHT deductions by contract, consultancy, rent, or supplies.
Late Filing Penalties
Compute statutory fines and CBN MPR interest on late remittances.
Statutory Deadlines
Query filing calendars, remittance grace periods, and agency rules.
Tax Law AI Query
Natural language tax queries grounded with authoritative vector search.
Tax Gazette Search
Full-text semantic search across gazettes, circulars, and tax acts.
AI Chat Completions
OpenAI-compatible streaming and conversational tax intelligence.