{"info":{"_postman_id":"12b1ea90-b0fc-4420-9e9a-eede233f1663","name":"Age Verify API","description":"

Identity Verification & Financial Management API

Setup:

Set base_url environment variable (e.g. https://app.ageverify.com.ng)
\n
Register or login — the api_token variable is set automatically
\n
All verification endpoints require a funded wallet
\n

Response Shape:

{ \"success\": true, \"message\": \"...\", \"data\": {...}, \"meta\": { \"timestamp\": \"...\" } }\n\n

Processing (202):
IPE Clearance, NIN Validation, Personalization, and BVN-by-Phone are processed manually by admin. Poll /api/v1/verifications/{reference} for status updates.

Role-Based Pricing:

Users with role: API pay api_price when set (falls back to standard price)
\n
API users can manage tokens via /api/v1/auth/token/\\\\* endpoints
\n
API users have access to web UI at /api-keys for token management
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"42472303","collectionId":"12b1ea90-b0fc-4420-9e9a-eede233f1663","publishedId":"2sBXietaPo","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-12T13:03:06.000Z"},"item":[{"name":"Wallet","item":[{"name":"Get Balance","id":"bd90fce1-83ac-478d-8b9b-05c312334fe4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/wallet/balance","urlObject":{"path":["api","v1","wallet","balance"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"6bcb34eb-004c-48ff-8b6e-78a89da469b7","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/wallet/balance"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Wallet balance retrieved.\",\n \"data\": {\n \"balance_kobo\": 500000,\n \"balance_ngn\": 5000.00,\n \"balance_formatted\": \"₦5,000.00\",\n \"currency\": \"NGN\",\n \"status\": \"active\"\n },\n \"meta\": { \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"}],"_postman_id":"bd90fce1-83ac-478d-8b9b-05c312334fe4"}],"id":"a8e371ea-d607-407c-8868-819be9948e85","description":"

Check balance. Fund wallet via virtual account transfer.

\n","_postman_id":"a8e371ea-d607-407c-8868-819be9948e85"},{"name":"Verification","item":[{"name":"NIN by NIN","id":"54c109e4-7280-44fd-9992-285247cdc76e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"nin\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-id","urlObject":{"path":["api","v1","verify","nin-id"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"eb835531-23fb-45b4-afbf-de11f766d052","name":"200 Completed","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"nin\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-id"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Verification completed successfully.\",\n \"data\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"nin_verification\",\n \"status\": \"completed\",\n \"cost_kobo\": 30000,\n \"cost_ngn\": 300.00,\n \"data\": {\n \"firstname\": \"JOHN\",\n \"lastname\": \"DOE\",\n \"middlename\": \"JAMES\",\n \"phone\": \"08012345678\",\n \"dob\": \"1990-01-15\",\n \"gender\": \"M\",\n \"address\": \"12 Example Street, Lagos\"\n },\n \"remark\": null,\n \"download_url\": null,\n \"created_at\": \"2026-03-06T14:00:00+00:00\",\n \"updated_at\": \"2026-03-06T14:00:01+00:00\"\n },\n \"meta\": { \"reference\": \"VER-ABCDEF123456\", \"status\": \"completed\", \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"},{"id":"e8fb5667-714e-4bce-b9e2-1296b6da56c8","name":"400 Not Found","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"nin\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-id"},"status":"Bad Request","code":400,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"No record found for the provided NIN.\",\n \"meta\": { \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"},{"id":"81749bf3-01a6-4bf5-82b9-1ac771c6d468","name":"400 Insufficient Funds","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"nin\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-id"},"status":"Bad Request","code":400,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Insufficient funds for this verification.\",\n \"meta\": { \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"},{"id":"43d1b956-7929-4037-893f-e6e5790da210","name":"422 Validation Error","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"nin\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-id"},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"NIN must be exactly 11 digits.\",\n \"errors\": { \"nin\": [\"NIN must be exactly 11 digits.\"] },\n \"meta\": { \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"}],"_postman_id":"54c109e4-7280-44fd-9992-285247cdc76e"},{"name":"NIN by Phone","id":"36a24f3c-0f9b-421a-9bb8-de8aa1d29a39","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"phone_number\": \"08012345678\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-phone","urlObject":{"path":["api","v1","verify","nin-phone"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"9cf81f8b-01a4-4a3a-a501-2de9df90ba27","name":"200 Completed","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"phone_number\": \"08012345678\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-phone"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Verification completed successfully.\",\n \"data\": {\n \"reference\": \"VER-PHONE123456\",\n \"service\": \"nin_by_phone\",\n \"status\": \"completed\",\n \"cost_kobo\": 30000,\n \"cost_ngn\": 300.00,\n \"data\": {\n \"firstname\": \"JANE\",\n \"lastname\": \"SMITH\",\n \"nin\": \"98765432101\"\n },\n \"remark\": null,\n \"download_url\": null,\n \"created_at\": \"2026-03-06T14:00:00+00:00\",\n \"updated_at\": \"2026-03-06T14:00:01+00:00\"\n },\n \"meta\": { \"reference\": \"VER-PHONE123456\", \"status\": \"completed\", \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"}],"_postman_id":"36a24f3c-0f9b-421a-9bb8-de8aa1d29a39"},{"name":"NIN by Demographics","id":"323a3f68-fe73-4fc1-b583-324603b4fe36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"firstname\": \"John\",\n \"lastname\": \"Doe\",\n \"dob\": \"1990-01-15\",\n \"gender\": \"M\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-demo","urlObject":{"path":["api","v1","verify","nin-demo"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"bfaa3608-29f8-4257-a893-bb9494198b7b","name":"200 Completed","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"firstname\": \"John\",\n \"lastname\": \"Doe\",\n \"dob\": \"1990-01-15\",\n \"gender\": \"M\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-demo"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Verification completed successfully.\",\n \"data\": {\n \"reference\": \"VER-DEMO123456\",\n \"service\": \"nin_demography\",\n \"status\": \"completed\",\n \"cost_kobo\": 30000,\n \"cost_ngn\": 300.00,\n \"data\": { \"nin\": \"12345678901\", \"firstname\": \"JOHN\", \"lastname\": \"DOE\" },\n \"remark\": null,\n \"download_url\": null,\n \"created_at\": \"2026-03-06T14:00:00+00:00\",\n \"updated_at\": \"2026-03-06T14:00:01+00:00\"\n },\n \"meta\": { \"reference\": \"VER-DEMO123456\", \"status\": \"completed\", \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"},{"id":"ddd9110a-adb1-41c2-9658-0b2e9958d6dd","name":"422 Validation Error","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"firstname\": \"John\",\n \"lastname\": \"Doe\",\n \"dob\": \"1990-01-15\",\n \"gender\": \"M\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-demo"},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Date of birth must be in YYYY-MM-DD format.\",\n \"errors\": { \"dob\": [\"Date of birth must be in YYYY-MM-DD format.\"] },\n \"meta\": { \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"}],"_postman_id":"323a3f68-fe73-4fc1-b583-324603b4fe36"},{"name":"BVN by BVN","id":"177ad8b0-a326-4584-a4b0-9d706b85667f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"bvn\": \"22234567890\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/bvn-id","urlObject":{"path":["api","v1","verify","bvn-id"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"2f1f0bea-1e0c-4c06-ad7c-380439e2cf9c","name":"200 Completed","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"bvn\": \"22234567890\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/bvn-id"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Verification completed successfully.\",\n \"data\": {\n \"reference\": \"VER-BVN1234567\",\n \"service\": \"bvn_verification\",\n \"status\": \"completed\",\n \"cost_kobo\": 30000,\n \"cost_ngn\": 300.00,\n \"data\": {\n \"firstname\": \"JOHN\",\n \"lastname\": \"DOE\",\n \"phone\": \"08012345678\",\n \"dob\": \"1990-01-15\",\n \"bank\": \"First Bank\"\n },\n \"remark\": null,\n \"download_url\": null,\n \"created_at\": \"2026-03-06T14:00:00+00:00\",\n \"updated_at\": \"2026-03-06T14:00:01+00:00\"\n },\n \"meta\": { \"reference\": \"VER-BVN1234567\", \"status\": \"completed\", \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"}],"_postman_id":"177ad8b0-a326-4584-a4b0-9d706b85667f"},{"name":"IPE Clearance (Manual — 202)","id":"38e81539-6b36-49f1-ac91-f27a4d516e95","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"identifier\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/ipe-clearance","urlObject":{"path":["api","v1","verify","ipe-clearance"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"2052933a-9a6a-4da1-b8e1-11a53cc915c8","name":"202 Processing","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"identifier\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/ipe-clearance"},"status":"Accepted","code":202,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Your request has been received and is being processed by our team.\",\n \"data\": null,\n \"meta\": {\n \"reference\": \"VER-IPE1234567\",\n \"status\": \"processing\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"38e81539-6b36-49f1-ac91-f27a4d516e95"},{"name":"NIN Validation (Manual — 202)","id":"469eb4dd-292e-4c8c-8864-ef00a92a3fbd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"nin\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-validation","urlObject":{"path":["api","v1","verify","nin-validation"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"29459e8e-a99e-4e10-b239-43da13fe1c0d","name":"202 Processing","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"nin\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/nin-validation"},"status":"Accepted","code":202,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Your request has been received and is being processed by our team.\",\n \"data\": null,\n \"meta\": {\n \"reference\": \"VER-VAL1234567\",\n \"status\": \"processing\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"469eb4dd-292e-4c8c-8864-ef00a92a3fbd"},{"name":"Personalization (Manual — 202)","id":"a917dcea-8528-4aef-9682-79d9fc3c61ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"tracking_id\": \"0T3YJPBSJR63NU2\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/personalization","urlObject":{"path":["api","v1","verify","personalization"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"119252b8-30b0-4d33-9093-a7513493f665","name":"202 Processing","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"tracking_id\": \"0T3YJPBSJR63NU2\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/personalization"},"status":"Accepted","code":202,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Your request has been received and is being processed by our team.\",\n \"data\": null,\n \"meta\": {\n \"reference\": \"VER-PER1234567\",\n \"status\": \"processing\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"},{"id":"d85d60fd-86b5-4f70-bc73-c731fb02714c","name":"200 Completed (with download)","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"tracking_id\": \"0T3YJPBSJR63NU2\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/verify/personalization"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Verification completed successfully.\",\n \"data\": {\n \"reference\": \"VER-PER1234567\",\n \"service\": \"personalization\",\n \"status\": \"completed\",\n \"cost_kobo\": 100000,\n \"cost_ngn\": 1000.00,\n \"data\": null,\n \"remark\": \"Personalization slip uploaded.\",\n \"download_url\": \"https://yourapp.com/storage/slips/slip_VER-PER1234567.pdf\",\n \"created_at\": \"2026-03-06T14:00:00+00:00\",\n \"updated_at\": \"2026-03-07T09:00:00+00:00\"\n },\n \"meta\": { \"reference\": \"VER-PER1234567\", \"status\": \"completed\", \"timestamp\": \"2026-03-07T09:00:00+00:00\" }\n}"}],"_postman_id":"a917dcea-8528-4aef-9682-79d9fc3c61ba"},{"name":"Get Single Verification","id":"e37fb2d1-e411-4559-98a4-7a0588d47008","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/verifications/VER-ABCDEF123456","urlObject":{"path":["api","v1","verifications","VER-ABCDEF123456"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"b2964861-3dae-4517-9247-5cc94662416f","name":"200 Completed","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/verifications/VER-ABCDEF123456"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Verification retrieved.\",\n \"data\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"nin_verification\",\n \"status\": \"completed\",\n \"cost_kobo\": 30000,\n \"cost_ngn\": 300.00,\n \"data\": { \"firstname\": \"JOHN\", \"lastname\": \"DOE\" },\n \"remark\": null,\n \"download_url\": null,\n \"created_at\": \"2026-03-06T14:00:00+00:00\",\n \"updated_at\": \"2026-03-06T14:00:01+00:00\"\n },\n \"meta\": { \"reference\": \"VER-ABCDEF123456\", \"status\": \"completed\", \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"},{"id":"22d68c3b-d04c-44d9-8d8e-b3c68eaa6261","name":"404 Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/verifications/VER-ABCDEF123456"},"status":"Not Found","code":404,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Verification not found.\",\n \"meta\": { \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"}],"_postman_id":"e37fb2d1-e411-4559-98a4-7a0588d47008"},{"name":"List Verification History","id":"11d4389a-0e5b-4be5-857a-adb932afd2fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/verifications?service_type=nin_verification&status=completed&per_page=20","urlObject":{"path":["api","v1","verifications"],"host":["http://localhost:8000"],"query":[{"description":{"content":"

Filter by service slug (e.g. nin_verification, bvn_verification, nin_ipe_clearance, nin_validation, personalization)

\n","type":"text/plain"},"key":"service_type","value":"nin_verification"},{"description":{"content":"

pending | processing | completed | failed | rejected

\n","type":"text/plain"},"key":"status","value":"completed"},{"description":{"content":"

Items per page (default 20)

\n","type":"text/plain"},"key":"per_page","value":"20"}],"variable":[]}},"response":[{"id":"ffd5cf5f-1d0c-4d8d-bdbe-cea51487c472","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":{"raw":"http://localhost:8000/api/v1/verifications?service_type=nin_verification&status=completed&per_page=20","host":["http://localhost:8000"],"path":["api","v1","verifications"],"query":[{"key":"service_type","value":"nin_verification","description":"Filter by service slug (e.g. nin_verification, bvn_verification, nin_ipe_clearance, nin_validation, personalization)"},{"key":"status","value":"completed","description":"pending | processing | completed | failed | rejected"},{"key":"per_page","value":"20","description":"Items per page (default 20)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Verifications retrieved.\",\n \"data\": {\n \"items\": [ { \"reference\": \"VER-ABCDEF123456\", \"service\": \"nin_verification\", \"status\": \"completed\", \"cost_ngn\": 300.00 } ],\n \"pagination\": { \"current_page\": 1, \"last_page\": 3, \"per_page\": 20, \"total\": 55 }\n },\n \"meta\": { \"timestamp\": \"2026-03-06T14:00:00+00:00\" }\n}"}],"_postman_id":"11d4389a-0e5b-4be5-857a-adb932afd2fc"}],"id":"4d143ba8-9003-4c3c-a989-bf286301ccf5","description":"

Submit identity verification requests and retrieve results.

Instant services (200): NIN by ID, NIN by Phone, NIN Demographic, BVN by BVN
Manual/queued (202): IPE Clearance, NIN Validation, Personalization

For 202 responses, poll GET /api/v1/verifications/{reference} for the final result.

Role-Based Pricing:

API-role users pay api_price when set on the service
\n
Falls back to standard price if api_price is null
\n
Other roles (USER, SMART, MANAGER, ADMIN) always pay standard price
\n

\n","_postman_id":"4d143ba8-9003-4c3c-a989-bf286301ccf5"},{"name":"Services","item":[{"name":"List Services","id":"a63d6578-1e22-435b-b0a2-d86bdb80724e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/services","urlObject":{"path":["api","v1","services"],"host":["http://localhost:8000"],"query":[],"variable":[]}},"response":[{"id":"16907882-a3a4-4966-a13c-886fb4ebb6f9","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"http://localhost:8000/api/v1/services"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"services\": [\n {\n \"id\": 1,\n \"name\": \"NIN Verification\",\n \"slug\": \"nin_verification\",\n \"description\": \"Verify National Identity Number\",\n \"price\": 100.00,\n \"api_price\": 80.00,\n \"is_active\": true,\n \"updated_at\": \"2026-03-06T14:00:00+00:00\"\n }\n ]\n}"}],"_postman_id":"a63d6578-1e22-435b-b0a2-d86bdb80724e"}],"id":"93bbe29e-6314-4656-a975-b1b612d7bb80","description":"

List available verification services and their prices.

Response includes:

price: Standard price in Naira
api_price: Special price for API-role users (nullable)

\n","_postman_id":"93bbe29e-6314-4656-a975-b1b612d7bb80"}],"variable":[{"key":"base_url","value":"http://localhost:8000","type":"string"},{"key":"api_token","value":"","type":"string"}]}