API Documentation

Public API endpoints for NIN, BVN, and VNIN verification

Base URL: https://www.idfixer.softel.ng/api/v1
Authentication

All requests require an api_key field in the JSON body. Obtain your API key from the Developer Portal.

POST https://www.idfixer.softel.ng/api/v1/nin/premium-slip NIN Premium Slip
Body Parameters: 
{
    "api_key": "string",
    "nin": "string (11 digits)"
}
POST https://www.idfixer.softel.ng/api/v1/nin/standard-slip NIN Standard Slip
Body Parameters: 
{
    "api_key": "string",
    "nin": "string"
}
POST https://www.idfixer.softel.ng/api/v1/nin/regular-slip NIN Regular Slip
Body Parameters: 
{
    "api_key": "string",
    "nin": "string"
}
POST https://www.idfixer.softel.ng/api/v1/nin/by-nin NIN by NIN
Body Parameters: 
{
    "api_key": "string",
    "nin": "string"
}
POST https://www.idfixer.softel.ng/api/v1/nin/by-phone NIN by Phone
Body Parameters: 
{
    "api_key": "string",
    "phone": "string (11 digits)"
}
POST https://www.idfixer.softel.ng/api/v1/nin/by-demo NIN by Demographics
Body Parameters: 
{
    "api_key": "string",
    "first_name": "string",
    "last_name": "string",
    "date_of_birth": "YYYY-MM-DD",
    "gender": "M|F"
}
POST https://www.idfixer.softel.ng/api/v1/bvn/premium-slip BVN Premium Slip
Body Parameters: 
{
    "api_key": "string",
    "bvn": "string (11 digits)"
}
POST https://www.idfixer.softel.ng/api/v1/bvn/standard-slip BVN Standard Slip
Body Parameters: 
{
    "api_key": "string",
    "bvn": "string"
}
POST https://www.idfixer.softel.ng/api/v1/vnin/premium-slip VNIN Slip
Body Parameters: 
{
    "api_key": "string",
    "vnin": "string"
}
POST https://www.idfixer.softel.ng/api/v1/nin/validation NIN Validation
Body Parameters: 
{
    "api_key": "string",
    "nin": "string",
    "first_name": "string",
    "last_name": "string"
}
Response Format
{
  "success": true,
  "data": { ... }
}

// On error:
{
  "success": false,
  "message": "Error description"
}