Get compliant in minutes, not months. Approved FIRS technical partner with local support that understands your business needs.
// Simple FIRS API Integration
import { FIRSApi } from '@firs-api-pro/sdk';
const firs = new FIRSApi({
apiKey: 'your-api-key',
environment: 'production'
});
// Create and submit invoice
const invoice = await firs.invoices.create({
customerTIN: '12345678-0001',
items: [{
description: 'Software License',
amount: 250000,
vatRate: 0.075
}]
});
console.log('Invoice created:', invoice.id);
// ✅ Status: Validated & SubmittedThe fastest, most reliable way to achieve FIRS e-invoicing compliance in Nigeria
Pre-built SDKs for popular platforms. Get up and running faster than any competitor with our simple, well-documented APIs.
Approved technical partner with FIRS. Always up-to-date with the latest regulations and requirements. Zero compliance risk.
Nigerian support team that understands your business context. Get help in your timezone with people who know the local market.
Much cheaper than building in-house. Save on development time, maintenance costs, and compliance management.
Process invoices in real-time with instant FIRS validation. Monitor status, track compliance, and get immediate feedback.
Supporting PHP, Python, Node.js, C#, and Java. Integrate with your existing tech stack seamlessly.
Get FIRS compliant in three simple steps
Simple API integration with your existing system using our pre-built SDKs for PHP, Python, Node.js, C#, and Java.
npm install @firs-api/sdkSet up your business details and tax information once. Our system handles all the FIRS compliance requirements automatically.
firs.configure({ tin: "12345678" })Automatic FIRS submission with every invoice. Real-time validation, digital signing, and compliance monitoring included.
firs.submitInvoice(invoice)Get started in minutes with our intuitive REST API
POST /api/v1/invoices
Authorization: Bearer your-api-key
Content-Type: application/json
{
"customerTIN": "12345678-0001",
"customerName": "Acme Corporation Ltd",
"invoiceDate": "2025-09-21",
"dueDate": "2025-10-21",
"items": [
{
"description": "Software License",
"quantity": 1,
"unitPrice": 250000,
"vatRate": 0.075,
"vatAmount": 18750
}
],
"totalAmount": 268750
}{
"id": "inv_1a2b3c4d5e6f",
"status": "draft",
"invoiceNumber": "INV-2025-001",
"firsReference": null,
"qrCode": "data:image/png;base64,iVBORw0KGgoA...",
"validationStatus": "pending",
"createdAt": "2025-09-21T10:30:00Z",
"updatedAt": "2025-09-21T10:30:00Z",
"downloadUrl": "https://api.firs-pro.com/invoices/inv_1a2b3c4d5e6f/pdf"
}POST /api/v1/invoices/inv_1a2b3c4d5e6f/validate
Authorization: Bearer your-api-key{
"id": "inv_1a2b3c4d5e6f",
"validationStatus": "valid",
"validatedAt": "2025-09-21T10:31:15Z",
"validationResults": {
"tinVerified": true,
"vatCalculationCorrect": true,
"formatCompliant": true,
"allFieldsPresent": true
},
"readyForSubmission": true
}POST /api/v1/invoices/inv_1a2b3c4d5e6f/submit
Authorization: Bearer your-api-key{
"id": "inv_1a2b3c4d5e6f",
"status": "submitted",
"firsReference": "FIRS-2025-0921-12345",
"submittedAt": "2025-09-21T10:32:30Z",
"firsStatus": "accepted",
"digitalSignature": "a1b2c3d4e5f6...",
"complianceVerified": true
}GET /api/v1/invoices/inv_1a2b3c4d5e6f
Authorization: Bearer your-api-key{
"id": "inv_1a2b3c4d5e6f",
"status": "submitted",
"firsReference": "FIRS-2025-0921-12345",
"complianceStatus": "compliant",
"lastUpdated": "2025-09-21T10:32:30Z",
"analytics": {
"processingTime": "45ms",
"validationScore": 100,
"complianceGrade": "A+"
}
}Choose the plan that fits your business needs
Compare your monthly costs across all plans and get a personalized recommendation
Join hundreds of Nigerian businesses already using our approved FIRS API service
Perfect! We have solutions designed specifically for small business owners who are just getting started with digital invoicing.