Citizen Full Info API | Smart Services ICPS

Request fields

Field	Description	Required
`nid_number`	Required string. Use the citizen NID number stored in the system.	Yes

Get full information

POST /api/v1/citizen/full-info

Example request

curl -X POST "https://mail.mosarofhosen.top/api/v1/citizen/full-info" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-API-SECRET: your_api_secret" \
  -d '{"nid_number":"1234567890"}'

Success response · HTTP 200

{
    "success": true,
    "message": "তথ্য পাওয়া গেছে",
    "package_used": "citizen_full_info",
    "endpoint_key": "citizen_full_info",
    "charged": 6,
    "balance": 994,
    "data": {
        "nid_number": "1234567890",
        "pin": "12345678901234567",
        "status_checked": true,
        "afis_status": "MATCHED",
        "lock_flag": "0",
        "voter_no": "123456789012",
        "form_no": "FORM-1001",
        "sl_no": "1001",
        "tag": null,
        "name_bn": "নমুনা নাগরিক",
        "name_en": "Sample Citizen",
        "date_of_birth": "1990-01-01T00:00:00.000000Z",
        "birth_place": "Dhaka",
        "birth_other": null,
        "birth_registration_no": null,
        "father_name": "Sample Father",
        "mother_name": "Sample Mother",
        "spouse_name": null,
        "gender": "male",
        "marital_status": "unmarried",
        "occupation": "Service",
        "disability": "none",
        "disability_other": null,
        "education": "Graduate",
        "education_other": null,
        "education_sub": null,
        "voter_documents": null,
        "smart_card_info": null,
        "identification": null,
        "blood_group": "A+",
        "tin": null,
        "driving_license_no": null,
        "passport_no": null,
        "laptop_id": null,
        "nid_father": null,
        "nid_mother": null,
        "nid_spouse": null,
        "voter_no_father": null,
        "voter_no_mother": null,
        "voter_no_spouse": null,
        "phone": null,
        "mobile": "01XXXXXXXXX",
        "email": "citizen@example.com",
        "religion": null,
        "religion_other": null,
        "death_date_father": null,
        "death_date_mother": null,
        "death_date_spouse": null,
        "no_finger": 10,
        "no_fingerprint": 10,
        "voter_area": "Sample Voter Area",
        "voter_at": "Sample Center",
        "photo_url": "https://mail.mosarofhosen.top/assets/citizens/1234567890_photo.jpg",
        "signature_url": null,
        "present_division": "Dhaka",
        "present_district": "Dhaka",
        "present_rmo": null,
        "present_city_corporation": "Dhaka South",
        "present_municipality": null,
        "present_upozila": "Dhanmondi",
        "present_union_ward": "Ward 15",
        "present_mouza_moholla": "Sample Moholla",
        "present_additional_mouza_moholla": null,
        "present_ward_for_union_porishod": null,
        "present_village_road": "Sample Road",
        "present_additional_village_road": null,
        "present_home_holding_no": "12/A",
        "present_post_office": "Dhanmondi",
        "present_postal_code": "1209",
        "present_region": "Dhaka",
        "permanent_division": "Dhaka",
        "permanent_district": "Dhaka",
        "permanent_rmo": null,
        "permanent_city_corporation": "Dhaka South",
        "permanent_municipality": null,
        "permanent_upozila": "Dhanmondi",
        "permanent_union_ward": "Ward 15",
        "permanent_mouza_moholla": "Sample Moholla",
        "permanent_additional_mouza_moholla": null,
        "permanent_ward_for_union_porishod": null,
        "permanent_village_road": "Sample Road",
        "permanent_additional_village_road": null,
        "permanent_home_holding_no": "12/A",
        "permanent_post_office": "Dhanmondi",
        "permanent_postal_code": "1209",
        "permanent_region": "Dhaka"
    }
}

Common error responses

The API returns JSON with the matching HTTP status. The message can vary according to the exact package, balance, citizen or file condition.

HTTP 401 Missing credentials

{
    "success": false,
    "message": "X-API-KEY and X-API-SECRET headers are required."
}

HTTP 403 IP not allowed

{
    "success": false,
    "message": "This server IP is not allowed for the API client."
}

HTTP 404 Citizen or file not found

{
    "success": false,
    "message": "সিটিজেন পাওয়া যায়নি"
}

HTTP 422 Package, balance or configuration error

{
    "success": false,
    "message": "No active API package was found. Purchase a package before using this service."
}

HTTP 429 Minute rate limit exceeded

{
    "success": false,
    "message": "Per-minute request limit exceeded.",
    "limit_type": "minute",
    "limit": 30,
    "used": 30,
    "remaining": 0,
    "retry_after_seconds": 42
}

Data protection: Citizen information must only be accessed and processed with proper authorization, consent and legal basis.