IDFIXER API Reference

All available REST API endpoint URLs for NIN and BVN verification services.

Base URL: https://idfixer.com.ng/api/v1
All requests: POST  •  Content-Type: application/json  •  Auth: api_key in body
For full documentation with request/response examples, log in to your developer portal. View Full Docs
All endpoints accept api_key in the JSON request body. Click any endpoint URL to copy it. Contact support to get an API key.
Request Format
Send JSON body with your api_key + required parameter
POST https://idfixer.com.ng/api/v1/nin/premium-slip
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "nin": "12345678901"
}
NIN Endpoints
12 endpoints
Endpoints
NIN Premium Slip
Full NIN details with photo and biometrics
Params: nin
POST https://idfixer.com.ng/api/v1/nin/premium-slip
NIN Standard Slip
Standard NIN information (no biometrics)
Params: nin
POST https://idfixer.com.ng/api/v1/nin/standard-slip
NIN Regular Slip
Basic NIN information
Params: nin
POST https://idfixer.com.ng/api/v1/nin/regular-slip
NIN by NIN Number
Fetch NIN record directly by NIN number
Params: nin
POST https://idfixer.com.ng/api/v1/nin/by-nin
NIN by Phone
Retrieve NIN details using registered phone number
Params: phone, variant(optional: premium|standard|regular)
POST https://idfixer.com.ng/api/v1/nin/by-phone
NIN by Demographics
Search NIN by name and date of birth
Params: firstname, lastname, dob (DD-MM-YYYY), gender (m/f), variant(optional: premium|standard|regular)
POST https://idfixer.com.ng/api/v1/nin/by-demo
NIN Validation
Validate a NIN number
Params: nin
POST https://idfixer.com.ng/api/v1/nin/validation
NIN IPE Clearance
Submit IPE clearance request
Params: nin
POST https://idfixer.com.ng/api/v1/nin/ipe
NIN IPE Status
Check IPE clearance status
Params: nin
POST https://idfixer.com.ng/api/v1/nin/ipe-status
VNIN Slip
Generate virtual NIN (vNIN) slip by NIN number
Params: nin
POST https://idfixer.com.ng/api/v1/vnin/premium-slip
NIN Personalization
Submit a NIN personalization request instantly (async — starts request_status "pending")
Params: tracking_id (15 chars)
POST https://idfixer.com.ng/api/v1/nin/personalization
NIN Personalization Status
Free — check the live status/result (photo, name, DOB, gender, ID number) of a submitted personalization
Params: tracking_id (15 chars) or transaction_id
POST https://idfixer.com.ng/api/v1/nin/personalization-status
BVN Endpoints
6 endpoints
Endpoints
BVN Premium Slip
Full BVN details with photo
Params: bvn
POST https://idfixer.com.ng/api/v1/bvn/premium-slip
BVN Standard Slip
BVN full details (standard tier)
Params: bvn
POST https://idfixer.com.ng/api/v1/bvn/standard-slip
BVN Modification
Submit a BVN modification request (pending, admin-processed)
Params: bvn, nin, enrollment_type, variant_id
POST https://idfixer.com.ng/api/v1/bvn/modification
BVN Retrieval
Retrieve a BVN (phone + name: live, returns transaction_id; central risk: admin-processed)
Params: retrieval_type, phone/first_name/last_name or ticket_id
POST https://idfixer.com.ng/api/v1/bvn/retrieval
BVN Retrieval Status
Free status check for a live BVN retrieval (auto-refund on Failed)
Params: transaction_id or reference
POST https://idfixer.com.ng/api/v1/bvn/retrieval-status
BVN Registration
Submit a BVN user creation request (pending, admin-processed)
Params: bvn, first_name, last_name
POST https://idfixer.com.ng/api/v1/bvn/registration
Other Services
8 endpoints
Endpoints
NIN Modification
Submit a NIN modification request (pending, admin-processed)
Params: nin, variant_id
POST https://idfixer.com.ng/api/v1/nin/modification
NIN Validation (Manual)
Submit a NIN for manual validation (pending, admin-processed)
Params: nin, first_name, last_name, variant_id
POST https://idfixer.com.ng/api/v1/nin/validation-manual
CAC Retrieval
Look up an existing CAC business/company (pending, admin-processed)
Params: cac_name, registration_number
POST https://idfixer.com.ng/api/v1/cac/retrieval
Buy Airtime
Purchase airtime instantly
Params: network, phone, amount
POST https://idfixer.com.ng/api/v1/telecom/buy-airtime
PUK Retrieval
Retrieve a SIM PUK code (pending, admin-processed)
Params: network, phone
POST https://idfixer.com.ng/api/v1/telecom/puk-retrieval
Self Service Delinking
Submit a self-service delinking request (pending, admin-processed)
Params: email, nin
POST https://idfixer.com.ng/api/v1/self-service-delinking
JAMB Services
Submit a JAMB service request (pending, admin-processed)
Params: variant_id, jamb_identifier, jamb_year
POST https://idfixer.com.ng/api/v1/jamb-services
Attestation
Submit an attestation request (pending, admin-processed)
Params: phone, nin (+ optional demographic fields)
POST https://idfixer.com.ng/api/v1/attestation
Need an API Key or Support?

Contact us on WhatsApp to get your API key and start integrating today.

Chat on WhatsApp