{"info":{"_postman_id":"c1f4ea31-0a49-42a6-b22c-3980b0e7fcd0","name":"Age Verify API","description":"

Identity Verification & Financial Management API

Setup:

Set base_url environment variable (e.g. https://app.ageverify.com.ng)
Set api_token (a valid Sanctum token) for authenticated requests
All verification endpoints require a funded wallet

Response Shape:

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

Processing (202):\nIPE Clearance, NIN Validation, and Personalization 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)
Other roles (USER, SMART, MANAGER, ADMIN) always pay standard price

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"42472303","collectionId":"c1f4ea31-0a49-42a6-b22c-3980b0e7fcd0","publishedId":"2sBY4VJHDz","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-08-05T11:43:49.000Z"},"item":[{"name":"Wallet","item":[{"name":"Get Balance","id":"55746ce7-8675-41e3-ab0e-ee4f122f7f4c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/api/v1/wallet/balance","urlObject":{"path":["api","v1","wallet","balance"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"42d301c7-8721-4078-a9a7-cf677c7c4ffc","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/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,\n \"balance_formatted\": \"₦5,000.00\",\n \"currency\": \"NGN\",\n \"status\": \"active\"\n },\n \"meta\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"55746ce7-8675-41e3-ab0e-ee4f122f7f4c"}],"id":"9eab9012-d0f7-4b4a-9fa4-dec35e4d96fe","description":"

Check balance. Fund wallet via virtual account transfer.

\n","_postman_id":"9eab9012-d0f7-4b4a-9fa4-dec35e4d96fe"},{"name":"Verification","item":[{"name":"NIN by NIN","id":"070e1c4e-f7de-43e1-ba4b-16691165763d","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":"https://app.ageverify.com.ng/api/v1/verify/nin-id","urlObject":{"path":["api","v1","verify","nin-id"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"aad9a7dd-d1c4-45c8-9141-bd102c6ab8bc","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":"https://app.ageverify.com.ng/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 \"id\": 1,\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"nin_verification\",\n \"status\": \"completed\",\n \"data\": {\n \"nin\": \"\",\n \"result\": [\n {\n \"status\": \"completed\",\n \"firstname\": \"\",\n \"surname\": \"\",\n \"middlename\": \"\",\n \"gender\": \"\",\n \"dateOfBirth\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"imageUrl\": \"\",\n \"signatureUrl\": \"\",\n \"nin\": \"\",\n \"stateOfOrigin\": \"\",\n \"lgaOfOrigin\": \"\",\n \"placeOfOrigin\": \"\",\n \"stateOfResidence\": \"\",\n \"lgaOfResidence\": \"\",\n \"placeOfResidence\": \"\",\n \"residenceAddress\": \"\",\n \"residenceTown\": \"\",\n \"residenceStatus\": \"\",\n \"birthCountry\": \"\",\n \"birthState\": \"\",\n \"birthLga\": \"\",\n \"height\": \"\",\n \"title\": \"\",\n \"employmentStatus\": \"\",\n \"maritalStatus\": \"\",\n \"educationalLevel\": \"\",\n \"cardStatus\": \"\",\n \"nok_firstname\": \"\",\n \"nok_middlename\": \"\",\n \"nok_surname\": \"\",\n \"nok_address\": \"\",\n \"nok_lga\": \"\",\n \"nok_state\": \"\",\n \"nok_postalcode\": \"\",\n \"nok_town\": \"\",\n \"nspokenlang\": \"\",\n \"pmiddlename\": \"\",\n \"psurname\": \"\"\n }\n ],\n \"status\": \"completed\",\n \"photo_url\": \"\"\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:00+00:00\"\n },\n \"meta\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"status\": \"completed\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"},{"id":"bb4d4147-8dc3-4321-b0f8-c8cde4a786b2","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":"https://app.ageverify.com.ng/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\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"},{"id":"6f5aead3-1452-4d11-8af4-0c9d8189ae5c","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":"https://app.ageverify.com.ng/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\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"},{"id":"6cd08994-163d-4558-8c92-93a957d575bd","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":"https://app.ageverify.com.ng/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\": {\n \"nin\": [\n \"NIN must be exactly 11 digits.\"\n ]\n },\n \"meta\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"070e1c4e-f7de-43e1-ba4b-16691165763d"},{"name":"NIN by Phone","id":"b1611348-815f-46aa-8738-d6b16cdbcba5","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":"https://app.ageverify.com.ng/api/v1/verify/nin-phone","urlObject":{"path":["api","v1","verify","nin-phone"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"b2f5ef78-907a-4a97-a812-fc189e1e8f32","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":"https://app.ageverify.com.ng/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 \"id\": 1,\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"nin_by_phone\",\n \"status\": \"completed\",\n \"data\": {\n \"nin\": \"\",\n \"result\": [\n {\n \"status\": \"completed\",\n \"firstname\": \"\",\n \"surname\": \"\",\n \"middlename\": \"\",\n \"gender\": \"\",\n \"dateOfBirth\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"imageUrl\": \"\",\n \"signatureUrl\": \"\",\n \"nin\": \"\",\n \"stateOfOrigin\": \"\",\n \"lgaOfOrigin\": \"\",\n \"placeOfOrigin\": \"\",\n \"stateOfResidence\": \"\",\n \"lgaOfResidence\": \"\",\n \"placeOfResidence\": \"\",\n \"residenceAddress\": \"\",\n \"residenceTown\": \"\",\n \"residenceStatus\": \"\",\n \"birthCountry\": \"\",\n \"birthState\": \"\",\n \"birthLga\": \"\",\n \"height\": \"\",\n \"title\": \"\",\n \"employmentStatus\": \"\",\n \"maritalStatus\": \"\",\n \"educationalLevel\": \"\",\n \"cardStatus\": \"\",\n \"nok_firstname\": \"\",\n \"nok_middlename\": \"\",\n \"nok_surname\": \"\",\n \"nok_address\": \"\",\n \"nok_lga\": \"\",\n \"nok_state\": \"\",\n \"nok_postalcode\": \"\",\n \"nok_town\": \"\",\n \"nspokenlang\": \"\",\n \"pmiddlename\": \"\",\n \"psurname\": \"\"\n }\n ],\n \"status\": \"completed\",\n \"photo_url\": \"\"\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:00+00:00\"\n },\n \"meta\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"status\": \"completed\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"b1611348-815f-46aa-8738-d6b16cdbcba5"},{"name":"NIN by Demographics","id":"34b44333-0872-4c40-baed-0c3f5792dd6d","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":"https://app.ageverify.com.ng/api/v1/verify/nin-demo","urlObject":{"path":["api","v1","verify","nin-demo"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"2ad9008f-2ee8-45d6-89df-d02044d5dca3","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":"https://app.ageverify.com.ng/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 \"id\": 1,\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"nin_demography\",\n \"status\": \"completed\",\n \"data\": {\n \"nin\": \"\",\n \"result\": [\n {\n \"status\": \"completed\",\n \"firstname\": \"\",\n \"surname\": \"\",\n \"middlename\": \"\",\n \"gender\": \"\",\n \"dateOfBirth\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"imageUrl\": \"\",\n \"signatureUrl\": \"\",\n \"nin\": \"\",\n \"stateOfOrigin\": \"\",\n \"lgaOfOrigin\": \"\",\n \"placeOfOrigin\": \"\",\n \"stateOfResidence\": \"\",\n \"lgaOfResidence\": \"\",\n \"placeOfResidence\": \"\",\n \"residenceAddress\": \"\",\n \"residenceTown\": \"\",\n \"residenceStatus\": \"\",\n \"birthCountry\": \"\",\n \"birthState\": \"\",\n \"birthLga\": \"\",\n \"height\": \"\",\n \"title\": \"\",\n \"employmentStatus\": \"\",\n \"maritalStatus\": \"\",\n \"educationalLevel\": \"\",\n \"cardStatus\": \"\",\n \"nok_firstname\": \"\",\n \"nok_middlename\": \"\",\n \"nok_surname\": \"\",\n \"nok_address\": \"\",\n \"nok_lga\": \"\",\n \"nok_state\": \"\",\n \"nok_postalcode\": \"\",\n \"nok_town\": \"\",\n \"nspokenlang\": \"\",\n \"pmiddlename\": \"\",\n \"psurname\": \"\"\n }\n ],\n \"status\": \"completed\",\n \"photo_url\": \"\"\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:00+00:00\"\n },\n \"meta\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"status\": \"completed\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"},{"id":"d76d4352-6bfa-4c9a-a725-23801c3f41f6","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":"https://app.ageverify.com.ng/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\": {\n \"dob\": [\n \"Date of birth must be in YYYY-MM-DD format.\"\n ]\n },\n \"meta\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"34b44333-0872-4c40-baed-0c3f5792dd6d"},{"name":"BVN by BVN","id":"62070256-3f67-4cde-a932-ad7d37fa7fee","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":"https://app.ageverify.com.ng/api/v1/verify/bvn-id","urlObject":{"path":["api","v1","verify","bvn-id"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"079a0530-94f3-4019-a3fa-b58d1d01af25","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":"https://app.ageverify.com.ng/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 \"id\": 4,\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"bvn_verification\",\n \"status\": \"completed\",\n \"data\": {\n \"nin\": \"\",\n \"result\": [\n {\n \"status\": \"completed\",\n \"firstname\": \"\",\n \"surname\": \"\",\n \"middlename\": \"\",\n \"gender\": \"\",\n \"dateOfBirth\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"imageUrl\": \"\",\n \"signatureUrl\": \"\",\n \"bvn\": \"\",\n \"nin\": \"\",\n \"nationality\": \"\",\n \"nameOnCard\": \"\",\n \"phone2\": \"\",\n \"enrollmentBank\": \"\",\n \"enrollmentBranch\": \"\",\n \"levelOfAccount\": \"\",\n \"watchListed\": \"\",\n \"registrationDate\": \"\",\n \"stateOfOrigin\": \"\",\n \"lgaOfOrigin\": \"\",\n \"stateOfResidence\": \"\",\n \"lgaOfResidence\": \"\",\n \"residenceAddress\": \"\",\n \"maritalStatus\": \"\",\n \"title\": \"\"\n }\n ],\n \"status\": \"completed\",\n \"photo_url\": \"\"\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:00+00:00\"\n },\n \"meta\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"status\": \"completed\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"62070256-3f67-4cde-a932-ad7d37fa7fee"},{"name":"IPE Clearance (Manual — 202)","id":"5fb9bbac-02d8-4006-89e3-c36fe3ee7785","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":"https://app.ageverify.com.ng/api/v1/verify/ipe-clearance","urlObject":{"path":["api","v1","verify","ipe-clearance"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"4bb00251-c7e3-42b2-8a2d-c28610404368","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":"https://app.ageverify.com.ng/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-ABCDEF123456\",\n \"status\": \"processing\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"5fb9bbac-02d8-4006-89e3-c36fe3ee7785"},{"name":"NIN Validation (Manual — 202)","id":"b3ed6e06-f43a-4dc6-93bc-d2e51322afcb","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":"https://app.ageverify.com.ng/api/v1/verify/nin-validation","urlObject":{"path":["api","v1","verify","nin-validation"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"56f9e667-6abf-41a7-beb4-d1dc21ffc657","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":"https://app.ageverify.com.ng/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-ABCDEF123456\",\n \"status\": \"processing\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"b3ed6e06-f43a-4dc6-93bc-d2e51322afcb"},{"name":"Personalization (Manual — 202)","id":"e9c498d2-1b7f-4966-97f4-7456dab63638","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":"https://app.ageverify.com.ng/api/v1/verify/personalization","urlObject":{"path":["api","v1","verify","personalization"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"552303b4-cc24-4300-9358-a857f5b6b30a","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":"https://app.ageverify.com.ng/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":"d27d15f1-e29b-4c4f-89f0-f825bf1f4744","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":"https://app.ageverify.com.ng/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 \"id\": 1,\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"personalization\",\n \"status\": \"completed\",\n \"data\": {\n \"nin\": \"\",\n \"result\": [\n {\n \"status\": \"completed\",\n \"firstname\": \"\",\n \"surname\": \"\",\n \"middlename\": \"\",\n \"gender\": \"\",\n \"dateOfBirth\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"imageUrl\": \"\",\n \"signatureUrl\": \"\",\n \"nin\": \"\",\n \"stateOfOrigin\": \"\",\n \"lgaOfOrigin\": \"\",\n \"placeOfOrigin\": \"\",\n \"stateOfResidence\": \"\",\n \"lgaOfResidence\": \"\",\n \"placeOfResidence\": \"\",\n \"residenceAddress\": \"\",\n \"residenceTown\": \"\",\n \"residenceStatus\": \"\",\n \"birthCountry\": \"\",\n \"birthState\": \"\",\n \"birthLga\": \"\",\n \"height\": \"\",\n \"title\": \"\",\n \"employmentStatus\": \"\",\n \"maritalStatus\": \"\",\n \"educationalLevel\": \"\",\n \"cardStatus\": \"\",\n \"nok_firstname\": \"\",\n \"nok_middlename\": \"\",\n \"nok_surname\": \"\",\n \"nok_address\": \"\",\n \"nok_lga\": \"\",\n \"nok_state\": \"\",\n \"nok_postalcode\": \"\",\n \"nok_town\": \"\",\n \"nspokenlang\": \"\",\n \"pmiddlename\": \"\",\n \"psurname\": \"\"\n }\n ],\n \"status\": \"completed\",\n \"photo_url\": \"\"\n },\n \"remark\": null,\n \"download_url\": \"https://api.ageverify.com.ng/downloads/VER-ABCDEF123456.pdf\",\n \"created_at\": \"2026-03-06T14:00:00+00:00\",\n \"updated_at\": \"2026-03-06T14:00:00+00:00\"\n },\n \"meta\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"status\": \"completed\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"e9c498d2-1b7f-4966-97f4-7456dab63638"},{"name":"Get Single Verification","id":"b0e9e8ed-c8be-4ab5-b93c-feceba44c8f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/api/v1/verifications/VER-ABCDEF123456","urlObject":{"path":["api","v1","verifications","VER-ABCDEF123456"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"2799a2b4-f756-42c5-b7bf-f564d5f73b9f","name":"200 Completed","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/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 \"id\": 1,\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"nin_verification\",\n \"status\": \"completed\",\n \"data\": {\n \"nin\": \"\",\n \"result\": [\n {\n \"status\": \"completed\",\n \"firstname\": \"\",\n \"surname\": \"\",\n \"middlename\": \"\",\n \"gender\": \"\",\n \"dateOfBirth\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"imageUrl\": \"\",\n \"signatureUrl\": \"\",\n \"nin\": \"\",\n \"stateOfOrigin\": \"\",\n \"lgaOfOrigin\": \"\",\n \"placeOfOrigin\": \"\",\n \"stateOfResidence\": \"\",\n \"lgaOfResidence\": \"\",\n \"placeOfResidence\": \"\",\n \"residenceAddress\": \"\",\n \"residenceTown\": \"\",\n \"residenceStatus\": \"\",\n \"birthCountry\": \"\",\n \"birthState\": \"\",\n \"birthLga\": \"\",\n \"height\": \"\",\n \"title\": \"\",\n \"employmentStatus\": \"\",\n \"maritalStatus\": \"\",\n \"educationalLevel\": \"\",\n \"cardStatus\": \"\",\n \"nok_firstname\": \"\",\n \"nok_middlename\": \"\",\n \"nok_surname\": \"\",\n \"nok_address\": \"\",\n \"nok_lga\": \"\",\n \"nok_state\": \"\",\n \"nok_postalcode\": \"\",\n \"nok_town\": \"\",\n \"nspokenlang\": \"\",\n \"pmiddlename\": \"\",\n \"psurname\": \"\"\n }\n ],\n \"status\": \"completed\",\n \"photo_url\": \"\"\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:00+00:00\"\n },\n \"meta\": {\n \"reference\": \"VER-ABCDEF123456\",\n \"status\": \"completed\",\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"},{"id":"28614c20-a102-4873-9806-a3c7a0c3ea5f","name":"404 Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/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\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"b0e9e8ed-c8be-4ab5-b93c-feceba44c8f3"},{"name":"List Verification History","id":"542ea3b4-7839-4b08-a6db-1c4fdecee1e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/api/v1/verifications?service_type=nin_verification&status=completed&per_page=20","urlObject":{"path":["api","v1","verifications"],"host":["https://app.ageverify.com.ng"],"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":"da7545b9-d580-48eb-9703-44ba028a07f4","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://app.ageverify.com.ng/api/v1/verifications?service_type=nin_verification&status=completed&per_page=20","host":["https://app.ageverify.com.ng"],"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\": [\n {\n \"id\": 1,\n \"reference\": \"VER-ABCDEF123456\",\n \"service\": \"nin_verification\",\n \"status\": \"completed\",\n \"data\": {\n \"nin\": \"\",\n \"result\": [\n {\n \"status\": \"completed\",\n \"firstname\": \"\",\n \"surname\": \"\",\n \"middlename\": \"\",\n \"gender\": \"\",\n \"dateOfBirth\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"imageUrl\": \"\",\n \"signatureUrl\": \"\",\n \"nin\": \"\",\n \"stateOfOrigin\": \"\",\n \"lgaOfOrigin\": \"\",\n \"placeOfOrigin\": \"\",\n \"stateOfResidence\": \"\",\n \"lgaOfResidence\": \"\",\n \"placeOfResidence\": \"\",\n \"residenceAddress\": \"\",\n \"residenceTown\": \"\",\n \"residenceStatus\": \"\",\n \"birthCountry\": \"\",\n \"birthState\": \"\",\n \"birthLga\": \"\",\n \"height\": \"\",\n \"title\": \"\",\n \"employmentStatus\": \"\",\n \"maritalStatus\": \"\",\n \"educationalLevel\": \"\",\n \"cardStatus\": \"\",\n \"nok_firstname\": \"\",\n \"nok_middlename\": \"\",\n \"nok_surname\": \"\",\n \"nok_address\": \"\",\n \"nok_lga\": \"\",\n \"nok_state\": \"\",\n \"nok_postalcode\": \"\",\n \"nok_town\": \"\",\n \"nspokenlang\": \"\",\n \"pmiddlename\": \"\",\n \"psurname\": \"\"\n }\n ],\n \"status\": \"completed\",\n \"photo_url\": \"\"\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:00+00:00\"\n }\n ],\n \"pagination\": {\n \"current_page\": 1,\n \"last_page\": 3,\n \"per_page\": 20,\n \"total\": 55\n }\n },\n \"meta\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"542ea3b4-7839-4b08-a6db-1c4fdecee1e8"}],"id":"d54a5e20-ed98-4e97-bba5-8947e139fa2d","description":"

Submit identity verification requests and retrieve results.

Instant services (200): NIN by ID, NIN by Phone, NIN Demographic, BVN by BVN\nManual/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
Falls back to standard price if api_price is null
Other roles (USER, SMART, MANAGER, ADMIN) always pay standard price

Response Shape (sanitized):

cost_kobo / cost_ngn are no longer returned on verification responses
Provider-internal fields (payload, verified_by, amount, cost, tracking_id, user_email, etc.) are stripped
Identity data is returned under data.data.result[] (for provider lookups; manual records return data.data directly); only whitelisted identity fields are exposed

\n","_postman_id":"d54a5e20-ed98-4e97-bba5-8947e139fa2d"},{"name":"Download Services","item":[{"name":"Charge for Download","id":"6f1a2884-2d8a-429c-a9c0-2ad7baccc31b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"service_slug\": \"nin-premium-slip\",\n \"identifier\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"https://app.ageverify.com.ng/api/v1/services/charge-download","urlObject":{"path":["api","v1","services","charge-download"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"deb12361-65a0-4a9a-8966-1216d5c363c8","name":"200 Success (API user, api_price set)","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"service_slug\": \"nin-premium-slip\",\n \"identifier\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"https://app.ageverify.com.ng/api/v1/services/charge-download"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Payment successful. Your download is ready.\",\n \"charged\": true,\n \"amount\": 8000,\n \"transaction_ref\": \"TXN-ABC123\"\n}"},{"id":"4b2f7aae-9d8a-48a0-8fd4-724d0ac7dc28","name":"200 Success (standard price)","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"service_slug\": \"nin-premium-slip\",\n \"identifier\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"https://app.ageverify.com.ng/api/v1/services/charge-download"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Payment successful. Your download is ready.\",\n \"charged\": true,\n \"amount\": 10000,\n \"transaction_ref\": \"TXN-ABC123\"\n}"},{"id":"0c400e65-0fe9-4a15-a06c-937fdd82db6a","name":"200 Free Download","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"service_slug\": \"nin-premium-slip\",\n \"identifier\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"https://app.ageverify.com.ng/api/v1/services/charge-download"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Free download authorized.\",\n \"charged\": false\n}"},{"id":"9deb0380-c2ea-4c46-81f7-223dcc5a3399","name":"400 Insufficient Funds","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"service_slug\": \"nin-premium-slip\",\n \"identifier\": \"12345678901\"\n}","options":{"raw":{"language":"json"}}},"url":"https://app.ageverify.com.ng/api/v1/services/charge-download"},"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\": {\n \"timestamp\": \"2026-03-06T14:00:00+00:00\"\n }\n}"}],"_postman_id":"6f1a2884-2d8a-429c-a9c0-2ad7baccc31b"}],"id":"5fb4bbbb-6e63-4de8-8fb9-2bb473e18213","description":"

Charge wallet for downloadable slips/reports.

Role-Based Pricing: API users pay api_price when set, otherwise standard price.

Supported Slugs:

nin-premium-slip, nin-standard-slip, nin-long-slip, nin-datapage
bvn-report

\n","_postman_id":"5fb4bbbb-6e63-4de8-8fb9-2bb473e18213"},{"name":"Services","item":[{"name":"List Services","id":"bc8846c0-bc8a-44bd-874e-37136c51f23c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/api/v1/services","urlObject":{"path":["api","v1","services"],"host":["https://app.ageverify.com.ng"],"query":[],"variable":[]}},"response":[{"id":"13d2dbad-a65b-410f-b689-f4511d480bda","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"url":"https://app.ageverify.com.ng/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,\n \"api_price\": 80,\n \"is_active\": true,\n \"updated_at\": \"2026-03-06T14:00:00+00:00\"\n }\n ]\n}"}],"_postman_id":"bc8846c0-bc8a-44bd-874e-37136c51f23c"}],"id":"f3c45f78-2e82-46a5-8e86-bf06e36abc8b","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":"f3c45f78-2e82-46a5-8e86-bf06e36abc8b"}],"variable":[{"key":"base_url","value":"https://app.ageverify.com.ng"},{"key":"api_token","value":""}]}