> ## Documentation Index > Fetch the complete documentation index at: https://docs.idmetagroup.com/llms.txt > Use this file to discover all available pages before exploring further. # Kartu Keluarga Details Extraction > Extract structured fields from an Indonesian Kartu Keluarga (family card) without creating a Trust Validation. ## OpenAPI ````yaml stateless-verification-api/document-ocr/kartu-keluarga-details-extraction.openapi.json POST /api/v3/verifications/indonesia/kartu-keluarga-details-extraction-passthrough openapi: 3.0.3 info: title: Document OCR API - Kartu Keluarga Details Extraction version: 1.0.0 servers: - url: https://{environment-subdomain}.idmetagroup.com description: Your environment (replace `{environment-subdomain}`) variables: environment-subdomain: default: integrate description: IDmeta environment subdomain security: - bearerAuth: [] paths: /api/v3/verifications/indonesia/kartu-keluarga-details-extraction-passthrough: post: tags: - Document OCR summary: Kartu Keluarga Details Extraction description: >- Extract structured fields from an Indonesian Kartu Keluarga (family card) without creating a Trust Validation. parameters: - name: Authorization in: header required: true schema: type: string example: Bearer {your_api_token} requestBody: required: true content: multipart/form-data: schema: type: object required: - documentImage properties: documentImage: type: string format: binary description: >- The Kartu Keluarga image. JPG, JPEG, PNG, or PDF, up to 2 MB. A base64 string (raw or `data:` URI) is also accepted. metadata: type: object additionalProperties: true description: Optional key-value pairs echoed back in the response. responses: '200': description: >- The document was processed. Check `data.outcome` and `verificationStatus` to determine the result. content: application/json: examples: extracted: summary: extracted — VERIFIED value: success: true message: Indonesia Kartu Keluarga extraction processed successfully data: outcome: extracted fields: noKk: value: '3174012509870123' confidence: 99.18% headOfFamily: value: BUDI SANTOSO confidence: 98.72% address: street: value: JL. MERPATI RAYA NO. 12 confidence: 97.10% rt: value: '003' confidence: 98.90% rw: value: '007' confidence: 98.90% village: value: KEBAYORAN LAMA UTARA confidence: 97.55% district: value: KEBAYORAN LAMA confidence: 97.98% city: value: JAKARTA SELATAN confidence: 98.61% province: value: DKI JAKARTA confidence: 99.24% postalCode: value: '12240' confidence: 98.33% members: - name: value: BUDI SANTOSO confidence: 98.72% nik: value: '3174012509870004' confidence: 99.31% bloodType: value: O confidence: 95.40% gender: value: LAKI-LAKI confidence: 99.12% placeOfBirth: value: JAKARTA confidence: 98.66% dateOfBirth: value: '1987-09-25' confidence: 98.20% religion: value: ISLAM confidence: 99.45% education: value: S1 confidence: 96.80% occupation: value: KARYAWAN SWASTA confidence: 96.15% maritalStatus: value: KAWIN confidence: 98.05% relationship: value: KEPALA KELUARGA confidence: 97.70% citizenship: value: WNI confidence: 99.50% fatherName: value: SUPARDI confidence: 96.42% motherName: value: SRI WAHYUNI confidence: 96.88% - name: value: DEWI ANGGRAINI confidence: 98.10% nik: value: '3174014607900002' confidence: 99.05% bloodType: null gender: value: PEREMPUAN confidence: 99.20% placeOfBirth: value: SURABAYA confidence: 97.90% dateOfBirth: value: '1990-07-06' confidence: 98.44% religion: value: ISLAM confidence: 99.45% education: value: SLTA/SEDERAJAT confidence: 95.60% occupation: value: MENGURUS RUMAH TANGGA confidence: 94.35% maritalStatus: value: KAWIN confidence: 98.05% relationship: value: ISTRI confidence: 98.30% citizenship: value: WNI confidence: 99.50% fatherName: value: HARTONO confidence: 96.02% motherName: value: ENDANG SULISTYOWATI confidence: 95.77% issuedDate: value: '2018-06-20' confidence: 97.15% issuingCity: value: JAKARTA SELATAN confidence: 98.61% missingFields: [] verificationStatus: VERIFIED verificationStatusCode: 3 transactionId: 72af5d18-9c40-4b6e-8d31-af9027ce5b64 verificationType: kartu_keluarga_details_extraction metadata: null createdAt: '2026-09-01T05:02:44.000000Z' partial: summary: partial — REVIEW_NEEDED value: success: true message: Indonesia Kartu Keluarga extraction processed successfully data: outcome: partial fields: noKk: null headOfFamily: value: BUDI SANTOSO confidence: 98.72% address: street: value: JL. MERPATI RAYA NO. 12 confidence: 97.10% rt: value: '003' confidence: 98.90% rw: value: '007' confidence: 98.90% village: value: KEBAYORAN LAMA UTARA confidence: 97.55% district: value: KEBAYORAN LAMA confidence: 97.98% city: value: JAKARTA SELATAN confidence: 98.61% province: value: DKI JAKARTA confidence: 99.24% postalCode: value: '12240' confidence: 98.33% members: - name: value: BUDI SANTOSO confidence: 98.72% nik: value: '3174012509870004' confidence: 99.31% bloodType: value: O confidence: 95.40% gender: value: LAKI-LAKI confidence: 99.12% placeOfBirth: value: JAKARTA confidence: 98.66% dateOfBirth: value: '1987-09-25' confidence: 98.20% religion: value: ISLAM confidence: 99.45% education: value: S1 confidence: 96.80% occupation: value: KARYAWAN SWASTA confidence: 96.15% maritalStatus: value: KAWIN confidence: 98.05% relationship: value: KEPALA KELUARGA confidence: 97.70% citizenship: value: WNI confidence: 99.50% fatherName: value: SUPARDI confidence: 96.42% motherName: value: SRI WAHYUNI confidence: 96.88% - name: value: DEWI ANGGRAINI confidence: 98.10% nik: value: '3174014607900002' confidence: 99.05% bloodType: null gender: value: PEREMPUAN confidence: 99.20% placeOfBirth: value: SURABAYA confidence: 97.90% dateOfBirth: value: '1990-07-06' confidence: 98.44% religion: value: ISLAM confidence: 99.45% education: value: SLTA/SEDERAJAT confidence: 95.60% occupation: value: MENGURUS RUMAH TANGGA confidence: 94.35% maritalStatus: value: KAWIN confidence: 98.05% relationship: value: ISTRI confidence: 98.30% citizenship: value: WNI confidence: 99.50% fatherName: value: HARTONO confidence: 96.02% motherName: value: ENDANG SULISTYOWATI confidence: 95.77% issuedDate: value: '2018-06-20' confidence: 97.15% issuingCity: value: JAKARTA SELATAN confidence: 98.61% missingFields: - noKk verificationStatus: REVIEW_NEEDED verificationStatusCode: 2 transactionId: 72af5d18-9c40-4b6e-8d31-af9027ce5b64 verificationType: kartu_keluarga_details_extraction metadata: null createdAt: '2026-09-01T05:02:44.000000Z' rejected: summary: rejected — REJECTED value: success: true message: Indonesia Kartu Keluarga extraction processed successfully data: outcome: rejected fields: noKk: null headOfFamily: null address: street: null rt: null rw: null village: null district: null city: null province: null postalCode: null members: [] issuedDate: null issuingCity: null missingFields: - noKk - headOfFamily errorReason: wrong_document_type errorMessage: >- The uploaded document does not appear to be a Kartu Keluarga verificationStatus: REJECTED verificationStatusCode: 1 transactionId: 72af5d18-9c40-4b6e-8d31-af9027ce5b64 verificationType: kartu_keluarga_details_extraction metadata: null createdAt: '2026-09-01T05:02:44.000000Z' '400': description: The request body or the submitted image failed validation. content: application/json: examples: fileTooLarge: summary: File larger than 2 MB value: success: false code: VALIDATION_FAILED message: The documentImage may not be greater than 2 MB. verificationStatus: FAILED verificationStatusCode: 6 transactionId: 8e214a6c-9037-4bd1-b5fe-2c94718df063 verificationType: kartu_keluarga_details_extraction metadata: null createdAt: '2026-09-01T06:14:37.000000Z' '500': description: >- The request could not be processed — either an internal error occurred, or the OCR source was unavailable. Check `code` to distinguish the two. content: application/json: examples: internalError: summary: INTERNAL_ERROR value: success: false code: INTERNAL_ERROR message: >- An internal error has occurred while processing your request. Please try again later. verificationStatus: FAILED verificationStatusCode: 6 transactionId: 9c05b2ae-d371-4e68-a04f-16b7358cd9e2 verificationType: kartu_keluarga_details_extraction metadata: null createdAt: '2026-09-01T06:34:41.000000Z' sourceUnavailable: summary: SOURCE_UNAVAILABLE value: success: false code: SOURCE_UNAVAILABLE message: Mistral upstream error (HTTP 503). verificationStatus: FAILED verificationStatusCode: 6 transactionId: 9c05b2ae-d371-4e68-a04f-16b7358cd9e2 verificationType: kartu_keluarga_details_extraction metadata: null createdAt: '2026-09-01T06:21:09.000000Z' components: securitySchemes: bearerAuth: type: http scheme: bearer description: Use your API token as a Bearer token in the `Authorization` header. ````