{"info":{"_postman_id":"b782a570-0d51-4d85-b22e-90baebbab5fa","name":"KTP Extractor API","description":"<html><head></head><body><p>Complete API collection for Indonesian KTP (ID card) data extraction.</p>\n<h2 id=\"features\">Features</h2>\n<ul>\n<li>Extract KTP data from image files (JPG, JPEG, PNG)</li>\n<li>Automatic field extraction and validation</li>\n<li>High accuracy data extraction</li>\n</ul>\n<h2 id=\"authentication\">Authentication</h2>\n<p>All requests require an API key in the <code>x-api-co-id</code> header.</p>\n<h2 id=\"base-url\">Base URL</h2>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>https://use.api.co.id/ocr\n</code></pre><h2 id=\"file-requirements\">File Requirements</h2>\n<ul>\n<li><strong>Supported formats</strong>: JPG, JPEG, PNG</li>\n<li><strong>Maximum file size</strong>: 5 MB</li>\n<li><strong>Content</strong>: Valid Indonesian KTP (ID card) image</li>\n</ul>\n<h2 id=\"extracted-fields\">Extracted Fields</h2>\n<ul>\n<li>NIK (16-digit ID number)</li>\n<li>Nama (Full name)</li>\n<li>Tempat Lahir (Birth place)</li>\n<li>Tanggal Lahir (Birth date)</li>\n<li>Jenis Kelamin (Gender)</li>\n<li>Golongan Darah (Blood type)</li>\n<li>Alamat (Address)</li>\n<li>RT/RW</li>\n<li>Kelurahan (Village)</li>\n<li>Kecamatan (Subdistrict)</li>\n<li>Kota (City)</li>\n<li>Provinsi (Province)</li>\n<li>Agama (Religion)</li>\n<li>Status Perkawinan (Marital status)</li>\n<li>Pekerjaan (Occupation)</li>\n<li>Kewarganegaraan (Nationality)</li>\n<li>Berlaku Hingga (Valid until)</li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"b782a570-0d51-4d85-b22e-90baebbab5fa","publishedId":"2sB3dLUC27","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-11-29T13:50:24.000Z"},"item":[{"name":"KTP Extraction","item":[{"name":"Extract KTP from Image","id":"b3f30eaf-05cf-44f5-83ab-ef1f1caacfd9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"<p>Your API key for authentication</p>\n","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","description":"<p>KTP image file (JPG, JPEG, or PNG). Maximum size: 5 MB</p>\n","value":null}]},"url":"https://use.api.co.id/ocr/ktp-extract","description":"<p>Extract structured KTP data from an uploaded image file.</p>\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: POST</li>\n<li><strong>Content-Type</strong>: multipart/form-data</li>\n<li><strong>File field</strong>: <code>file</code> (required)</li>\n</ul>\n<h3 id=\"supported-file-types\">Supported File Types</h3>\n<ul>\n<li>JPG/JPEG (image/jpeg)</li>\n<li>PNG (image/png)</li>\n</ul>\n<h3 id=\"file-size-limit\">File Size Limit</h3>\n<ul>\n<li>Maximum: 5 MB</li>\n</ul>\n<h3 id=\"response\">Response</h3>\n<p>Returns complete KTP data with all extracted fields in JSON format.</p>\n","urlObject":{"path":["ocr","ktp-extract"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"32542586-ea08-477b-8a60-df9414582d75","name":"Success - KTP Extracted","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"ktp_sample.jpg"}]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": true,\n    \"message\": \"Success\",\n    \"data\": {\n        \"nik\": \"1234567890123456\",\n        \"nama\": \"JOHN DOE\",\n        \"tempat_lahir\": \"JAKARTA\",\n        \"tanggal_lahir\": \"01-01-1990\",\n        \"jenis_kelamin\": \"LAKI-LAKI\",\n        \"golongan_darah\": \"A\",\n        \"alamat\": \"JALAN CONTOH NO. 1\",\n        \"rt_rw\": \"001/002\",\n        \"kelurahan\": \"KELURAHAN CONTOH\",\n        \"kecamatan\": \"KECAMATAN CONTOH\",\n        \"kota\": \"JAKARTA\",\n        \"provinsi\": \"DKI JAKARTA\",\n        \"agama\": \"ISLAM\",\n        \"status_perkawinan\": \"BELUM KAWIN\",\n        \"pekerjaan\": \"PELAJAR MAHASISWA\",\n        \"kewarganegaraan\": \"WNI\",\n        \"berlaku_hingga\": \"SEUMUR HIDUP\"\n    }\n}"},{"id":"c2cbbe58-0b81-4c0d-84f4-7ec43bafb185","name":"Error - Missing API Key","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["ktp_sample.jpg"]}]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"User not authenticated\",\n    \"data\": null\n}"},{"id":"32e048a6-4ddd-43c0-9bb8-1687c2f1c78d","name":"Error - Missing File","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"File is required. Please upload an image file using 'file' field in multipart/form-data\",\n    \"data\": null\n}"},{"id":"b3fc0b18-6f01-42dc-858c-77dcdf409fc1","name":"Error - Invalid File Type","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["document.pdf"]}]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"Invalid file type. Only JPG, JPEG, and PNG image files are allowed\",\n    \"data\": null\n}"},{"id":"1a37e4a0-d6e1-466d-bf42-310968a87fb3","name":"Error - File Too Large","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["large_image.jpg"]}]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"File size exceeds maximum limit of 5 MB\",\n    \"data\": null\n}"},{"id":"9e660602-160c-48e9-9b46-b8340ab98692","name":"Error - Image Too Blurry","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["blurry_ktp.jpg"]}]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"Image is too blurry. Please upload a clear, sharp image of the KTP. Blur score: 45.23 (minimum required: 100)\",\n    \"data\": null\n}"},{"id":"6e5e4e10-9319-4dbe-b6a2-85cbe3b9daa5","name":"Error - No KTP Detected","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["random_image.jpg"]}]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"No KTP detected in the image. Please ensure the image contains a valid Indonesian ID card (KTP).\",\n    \"data\": null\n}"},{"id":"d3fe7763-ae72-42d0-93dd-343c81b19f21","name":"Error - Image Too Small","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["small_image.jpg"]}]},"url":"https://use.api.co.id/ocr/ktp-extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"Image too small. Minimum size: 200x200 pixels. Got: 150x180\",\n    \"data\": null\n}"}],"_postman_id":"b3f30eaf-05cf-44f5-83ab-ef1f1caacfd9"}],"id":"8b9ea193-1658-41f2-ad02-77e29367deae","description":"<p>KTP extraction endpoints for processing Indonesian ID card images.</p>\n","_postman_id":"8b9ea193-1658-41f2-ad02-77e29367deae"}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string","description":"Base URL for the API"},{"key":"api_key","value":"YOUR_API_KEY_HERE","type":"string","description":"Your API key for authentication. Get it from api.dashboard or your database."}]}