{ "info": { "_postman_id": "smartdata-kyc-api-v1", "name": "SmartData KYC API", "description": "SmartData KYC API — Identity & Business Verification\n\nBase URL: https://mysmartdata.tech\nSandbox Base: https://mysmartdata.tech/api/v1/sandbox\nProduction Base: https://mysmartdata.tech/api/v1\n\nSandbox API Key: sb_test_smartdata_sandbox_key_2025\n\nGenerated: 2026-10-19T06:47:08+00:00\n\nTest NRC Numbers:\n 100100/10/1 — Mwamba Chanda Kapembwa (Active)\n 200200/20/1 — Thandiwe Bwalya Mwale (Active)\n 300300/30/1 — Joseph Tembo Banda (Active)\n 400400/40/1 — Grace Mutale Phiri (Active)\n 500500/50/1 — Daniel Mulenga Zulu (Active)\n 600600/60/1 — Esther Nakamba Lungu (Active)\n 700700/70/1 — Peter Chisanga Mumba (Deceased)\n 800800/80/1 — Mary Chilufya Kasonde (Active)\n 900900/90/1 — James Kalaba Simwanza (Active)\n 111111/11/1 — Charity Mwila Sakala (Active)", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "https://mysmartdata.tech", "type": "string", "description": "Production base URL" }, { "key": "sandbox_base_url", "value": "https://mysmartdata.tech/api/v1/sandbox", "type": "string", "description": "Sandbox base URL — free, no auth required" }, { "key": "sandbox_api_key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "string", "description": "Sandbox API key — use for all sandbox requests" }, { "key": "production_api_key", "value": "YOUR_PRODUCTION_API_KEY", "type": "string", "description": "Your production sk_... API key from the dashboard" } ], "item": [ { "name": "🟡 Sandbox (No Auth Required)", "description": "All sandbox endpoints are free to use. No registration needed. Responses include _sandbox: true.", "item": [ { "name": "POST Single NRC Lookup — KYC (NHIMA + PACRA + Airtel + ZRA)", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"263327\\/71\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/kyc/lookup", "host": [ "{{sandbox_base_url}}" ], "path": [ "kyc", "lookup" ] }, "description": "Bundled sandbox KYC lookup.\n\nTest NRC: 263327/71/1\nReturns 200 with NHIMA, PACRA, Airtel, and ZRA payloads.\nImport this collection into Postman → Mock Server to demo without hitting the live API." }, "response": [ { "name": "200 — 263327/71/1 (NHIMA + PACRA + Airtel + ZRA)", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"SD-SB-20260831-KYC001\",\n \"nrc_number\": \"263327/71/1\",\n \"country\": \"ZM\",\n \"data\": {\n \"nhima\": {\n \"found\": true,\n \"status\": \"Registered\",\n \"member_number\": \"NHI-2021-88421\",\n \"scheme\": \"Formal Sector\",\n \"full_name\": \"Andrew Simwizi\",\n \"nrc\": \"263327/71/1\",\n \"employer\": {\n \"entity_id\": \"120200000001\",\n \"name\": \"Smart Data Limited\",\n \"status\": \"Registered\"\n },\n \"dependents\": [\n {\n \"full_name\": \"Mary Simwizi\",\n \"relationship\": \"Spouse\",\n \"status\": \"Active\"\n }\n ]\n },\n \"pacra\": {\n \"found\": true,\n \"directorships\": [\n {\n \"company_name\": \"Simwizi Holdings Limited\",\n \"registration_number\": \"120200012345\",\n \"status\": \"Active\",\n \"company_type\": \"Private Company Limited by Shares\",\n \"role\": \"Director\",\n \"date_of_registration\": \"2020-03-18\",\n \"nature_of_business\": \"Information technology consultancy\",\n \"isic_code\": \"6202\",\n \"isic_description\": \"Computer consultancy and computer facilities management activities\"\n }\n ]\n },\n \"airtel\": {\n \"found\": true,\n \"network\": \"Airtel\",\n \"msisdn\": \"0973790404\",\n \"first_name\": \"andrew\",\n \"last_name\": \"simwizi\",\n \"full_name\": \"andrew simwizi\",\n \"nrc\": \"263327711\",\n \"status\": \"SUBS\",\n \"verified\": true\n },\n \"zra\": {\n \"found\": true,\n \"tpin\": \"1002633271\",\n \"taxpayer_name\": \"Andrew Simwizi\",\n \"taxpayer_type\": \"Individual\",\n \"status\": \"Active\",\n \"nrc\": \"263327/71/1\",\n \"registration_date\": \"2018-06-12\"\n }\n },\n \"message\": \"KYC lookup successful.\",\n \"_sandbox\": true\n}", "_postman_previewlanguage": "json", "originalRequest": [] }, { "name": "404 — Unknown NRC", "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"reference\": \"SD-SB-20260831-XXXXXX\",\n \"error\": {\n \"code\": \"SMARTDATA_NOT_FOUND\",\n \"message\": \"ID number not found in the sandbox KYC catalogue.\"\n },\n \"_sandbox\": true,\n \"_hint\": \"Use test NRC 263327/71/1\"\n}", "_postman_previewlanguage": "json", "originalRequest": [] } ] }, { "name": "GET Test Data Catalogue", "request": { "method": "GET", "header": [], "url": { "raw": "{{sandbox_base_url}}/test-data", "host": [ "{{sandbox_base_url}}" ], "path": [ "test-data" ] }, "description": "Returns the full list of test NRC numbers and business search terms available in the sandbox." } }, { "name": "POST NRC Verify — Sandbox", "item": [ { "name": "100100/10/1 — Mwamba Chanda Kapembwa", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"100100\\/10\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Mwamba Chanda Kapembwa (Status: Active)." } }, { "name": "200200/20/1 — Thandiwe Bwalya Mwale", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"200200\\/20\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Thandiwe Bwalya Mwale (Status: Active)." } }, { "name": "300300/30/1 — Joseph Tembo Banda", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"300300\\/30\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Joseph Tembo Banda (Status: Active)." } }, { "name": "400400/40/1 — Grace Mutale Phiri", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"400400\\/40\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Grace Mutale Phiri (Status: Active)." } }, { "name": "500500/50/1 — Daniel Mulenga Zulu", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"500500\\/50\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Daniel Mulenga Zulu (Status: Active)." } }, { "name": "600600/60/1 — Esther Nakamba Lungu", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"600600\\/60\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Esther Nakamba Lungu (Status: Active)." } }, { "name": "700700/70/1 — Peter Chisanga Mumba", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"700700\\/70\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Peter Chisanga Mumba (Status: Deceased)." } }, { "name": "800800/80/1 — Mary Chilufya Kasonde", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"800800\\/80\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Mary Chilufya Kasonde (Status: Active)." } }, { "name": "900900/90/1 — James Kalaba Simwanza", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"900900\\/90\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for James Kalaba Simwanza (Status: Active)." } }, { "name": "111111/11/1 — Charity Mwila Sakala", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"111111\\/11\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "Sandbox NRC verification for Charity Mwila Sakala (Status: Active)." } }, { "name": "999999/99/9 — NOT FOUND — triggers 404 error", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"999999\\/99\\/9\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/nrc/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "nrc", "verify" ] }, "description": "This NRC is not in the fixture — will return a 404 SMARTDATA_NOT_FOUND error. Useful for testing error handling." } } ] }, { "name": "POST Business Verify — Sandbox", "item": [ { "name": "Acme Corp", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"search_term\": \"Acme Corp\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/business/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "business", "verify" ] }, "description": "Returns Acme Corporation Limited (COMP/2015/12345)" } }, { "name": "Zanaco", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"search_term\": \"Zanaco\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/business/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "business", "verify" ] }, "description": "Returns Zambia National Commercial Bank Plc" } }, { "name": "Trade Kings", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"search_term\": \"Trade Kings\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/business/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "business", "verify" ] }, "description": "Returns Trade Kings Limited" } }, { "name": "Shoprite", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"search_term\": \"Shoprite\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/business/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "business", "verify" ] }, "description": "Returns Shoprite Holdings Zambia Limited" } }, { "name": "COMP/2015/12345", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"search_term\": \"COMP\\/2015\\/12345\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/business/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "business", "verify" ] }, "description": "Lookup by registration number — returns Acme Corp" } }, { "name": "NonExistentCo", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "sb_test_smartdata_sandbox_key_2025", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"search_term\": \"NonExistentCo\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{sandbox_base_url}}/business/verify", "host": [ "{{sandbox_base_url}}" ], "path": [ "business", "verify" ] }, "description": "NOT FOUND — triggers 404 error for testing error handling" } } ] } ] }, { "name": "🟢 Production (API Key Required)", "description": "Production endpoints require a valid sk_... API key. Credits are deducted per verification.", "item": [ { "name": "POST NRC KYC Aggregate", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "{{production_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc\": \"123456\\/78\\/1\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/api/v1/nrc-kyc/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "nrc-kyc", "verify" ] }, "description": "Resolve one NRC into identity, linked mobile numbers, and health-insurance status.\n\nRequired header: X-API-Key (scope: nrc.verify)\nThe aggregate is charged once after identity resolution. Subsections can be unavailable while the response remains HTTP 200." }, "response": [ { "name": "Aggregate — All Sections Available", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"SD-REF-20260905-AGG001\",\n \"identity\": {\n \"name\": \"John Doe\",\n \"nrc\": \"123456/78/1\",\n \"dob\": \"1990-01-15\",\n \"gender\": \"Male\",\n \"tpin\": \"1001234567\",\n \"document_status\": \"Active\"\n },\n \"mobile\": {\n \"available\": true,\n \"linked_numbers\": [\n {\n \"msisdn\": \"0970000000\",\n \"network\": \"Airtel\",\n \"status\": \"ACTIVE\",\n \"registration_date\": \"2023-01-15\"\n }\n ]\n },\n \"nhima\": {\n \"available\": true,\n \"status\": \"Registered\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] }, { "name": "Aggregate — NHIMA Unavailable", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"SD-REF-20260905-AGG002\",\n \"identity\": {\n \"name\": \"John Doe\",\n \"nrc\": \"123456/78/1\",\n \"dob\": \"1990-01-15\",\n \"gender\": \"Male\",\n \"tpin\": \"1001234567\",\n \"document_status\": \"Active\"\n },\n \"mobile\": {\n \"available\": true,\n \"linked_numbers\": [\n {\n \"msisdn\": \"0970000000\",\n \"network\": \"Airtel\",\n \"status\": \"ACTIVE\",\n \"registration_date\": \"2023-01-15\"\n }\n ]\n },\n \"nhima\": {\n \"available\": false,\n \"error\": \"Health-insurance service is unavailable.\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] }, { "name": "Aggregate — Invalid API Key", "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"reference\": \"SD-REF-20260905-AGG003\",\n \"error\": {\n \"code\": \"SMARTDATA_ACCESS_DENIED\",\n \"message\": \"Invalid or revoked API key.\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] }, { "name": "Aggregate — NRC Not Found", "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"reference\": \"SD-REF-20260905-AGG004\",\n \"error\": {\n \"code\": \"NOT_FOUND\",\n \"message\": \"NRC identity was not found.\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] } ] }, { "name": "POST NRC Mobile Verify", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "{{production_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc\": \"123456\\/78\\/1\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/api/v1/nrc-mobile/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "nrc-mobile", "verify" ] }, "description": "Look up mobile numbers linked to an NRC.\n\nRequired header: X-API-Key (scope: nrc.verify)" }, "response": [ { "name": "NRC Mobile Verify — Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"VER-20260905-53LJ4N\",\n \"nrc\": \"123456/78/1\",\n \"data\": {\n \"nrc\": \"123456781\",\n \"full_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"date_of_birth\": \"1990-01-01\",\n \"gender\": \"Male\",\n \"province\": \"Lusaka\",\n \"district\": \"Lusaka\",\n \"nationality\": \"Zambian\",\n \"document_status\": \"VALID\",\n \"linked_numbers\": [\n {\n \"msisdn\": \"0970000000\",\n \"network\": \"Airtel\",\n \"status\": \"ACTIVE\",\n \"registration_date\": \"2023-01-15\"\n }\n ]\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] } ] }, { "name": "POST NRC Verify", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "{{production_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nrc_number\": \"123456\\/78\\/1\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/api/v1/nrc/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "nrc", "verify" ] }, "description": "Verify a National Registration Card (NRC) number.\n\nRequired header: X-API-Key (scope: nrc.verify)\nReplace nrc_number with the NRC to verify.\ncountry defaults to ZM if omitted." }, "response": [ { "name": "NRC Verify — Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"SD-REF-20260319-XXXX\",\n \"id_number\": \"123456/78/1\",\n \"data\": {\n \"full_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"middle_name\": \"Michael\",\n \"date_of_birth\": \"1990-01-15\",\n \"gender\": \"Male\",\n \"nationality\": \"Zambian\",\n \"province\": \"Lusaka\",\n \"district\": \"Lusaka\",\n \"status\": \"Active\",\n \"is_active\": true\n },\n \"message\": \"Verification successful.\"\n}", "_postman_previewlanguage": "json", "originalRequest": [] }, { "name": "NRC Verify — Not Found", "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"reference\": \"SD-REF-20260319-XXXX\",\n \"error\": {\n \"code\": \"SMARTDATA_NOT_FOUND\",\n \"message\": \"ID number not found in the national database.\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] }, { "name": "NRC Verify — Invalid Key", "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"SMARTDATA_ACCESS_DENIED\",\n \"message\": \"Invalid or revoked API key.\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] } ] }, { "name": "POST Business Verify", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "{{production_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"search_term\": \"Acme Corp\",\n \"country\": \"ZM\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/api/v1/business/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "business", "verify" ] }, "description": "Look up a business by name or registration number.\n\nRequired header: X-API-Key (scope: business.lookup)\nsearch_term: business name or registration number.\ncountry defaults to ZM if omitted." }, "response": [ { "name": "Business Verify — Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"SD-REF-20260319-XXXX\",\n \"data\": {\n \"company_name\": \"Acme Corporation Limited\",\n \"registration_number\": \"COMP/2015/12345\",\n \"status\": \"Active\",\n \"company_type\": \"Private Company Limited by Shares\",\n \"date_of_registration\": \"2015-06-20\",\n \"address\": \"Plot 1234, Cairo Road, Lusaka\",\n \"directors\": [\n \"John Doe\",\n \"Jane Smith\"\n ]\n },\n \"message\": \"Business lookup successful.\"\n}", "_postman_previewlanguage": "json", "originalRequest": [] }, { "name": "Business Verify — Not Found", "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"SMARTDATA_NOT_FOUND\",\n \"message\": \"Business not found in the registry.\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] } ] }, { "name": "POST Mobile Verify", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "{{production_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"msisdn\": \"0973790404\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/api/v1/mobile/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "mobile", "verify" ] }, "description": "Look up a mobile number via the SmartData KYC API.\n\nRequired header: X-API-Key (scope: nrc.verify)" }, "response": [ { "name": "Mobile Verify — Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"SD-REF-20260826-XXXX\",\n \"msisdn\": \"0973790404\",\n \"data\": {\n \"msisdn\": \"973790404\",\n \"first_name\": \"andrew\",\n \"last_name\": \"simwizi\",\n \"full_name\": \"andrew simwizi\",\n \"nrc\": \"263327711\",\n \"status\": \"SUBS\",\n \"verified\": true\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] } ] }, { "name": "POST Health Insurance Verify", "request": { "method": "POST", "header": [ { "key": "X-API-Key", "value": "{{production_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"lookup_type\": \"employee_status\",\n \"national_id\": \"299352\\/24\\/1\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/api/v1/health-insurance/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "health-insurance", "verify" ] }, "description": "Look up health-insurance registration via the SmartData KYC API.\n\nRequired header: X-API-Key (scope: nrc.verify)\nlookup_type: employee_status | beneficiaries | member | dependents\nEmployer lookup: POST /api/v1/health-insurance/employer with entity_id (scope: business.lookup)" }, "response": [ { "name": "Health Insurance Verify — Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"reference\": \"SD-REF-20260826-XXXX\",\n \"lookup_type\": \"employee_status\",\n \"identifier\": \"299352/24/1\",\n \"data\": {\n \"status\": \"Registered\",\n \"name\": \"Jane Banda\"\n }\n}", "_postman_previewlanguage": "json", "originalRequest": [] } ] } ] }, { "name": "📋 Error Reference", "description": "Standard error codes returned by the SmartData KYC API:\n\nSMARTDATA_ACCESS_DENIED — 401/403 — Invalid key, expired, or IP blocked\nSMARTDATA_RATE_LIMITED — 429 — Too many requests\nSMARTDATA_INSUFFICIENT_BALANCE — 402 — Top up account balance\nSMARTDATA_NOT_FOUND — 404 — ID or business not found\nSMARTDATA_COUNTRY_NOT_AVAILABLE — 403 — Country not on your plan\nSMARTDATA_SCOPE_NOT_PERMITTED — 403 — API key missing required scope\nSMARTDATA_SERVICE_UNAVAILABLE — 503 — Temporary outage, retry later", "item": [] } ] }