FiducaHub's NRS API Distribution Platform

Secure multi-tenant API for Nigeria Revenue Service (NRS) E-Invoice System

โ— v1.0.0 OAuth2 OpenAPI 3.1 Rate Limited Consent Required
๐Ÿ“˜ Swagger ๐Ÿ“– View Redoc

๐Ÿงช Sandbox / UAT Testing Guide

Quick Start: Login → Authorize → Test
Step 1 Call POST /auth/user/login with your registered email & password
Step 2 Copy the access_token from the response
Step 3 Click Authorize above and enter Bearer <access_token>
Step 4 Use Try it out on any /api/v1/* endpoint
Alternatively: OAuth2 Flow
OAuth2 POST /oauth/token with your client_id + client_secret → Bearer token
Reference Formats
TIN Format XXXXXXXXXXXXX (NRS Tax ID: 13 numeric digits, linked to NIN). Legacy XXXXXXXXXX-XXXX temporarily accepted.
IRN Format {InvoiceNo}-{ServiceID(8)}-{YYYYMMDD}
Admin Headers X-Admin-Key + X-Admin-Secret (for /admin/* routes)

Credentials are configured in your environment. Contact your platform operator if you need sandbox access.