---
title: "Get KTP Extraction Result"
method: GET
path: "/ktp/id/extract-async/result"
tags: ["KTP - Asynchronous"]
---

# Get KTP Extraction Result

`GET /ktp/id/extract-async/result`

## Request

- Base URL: `https://api.verihubs.com`
- URL: `https://api.verihubs.com/ktp/id/extract-async/result`
- Auth: none declared. Required headers: `App-ID`, `API-Key`

This method helps you to get the recognition result of extract KTP asynchronous.  </br>
  


You will receive a response of your payload request which consists of message and an error code if the request fails to process. The following is a list of error codes of get KTP extraction payload request.
<br>

|Error status| Error code                    | Description                                  |
|----------| ------------------------------|----------------------------------------------|
|400| INVALID_PAYLOAD_REFERENCE_ID | reference_id is too short/too long |
|404| INVALID_PAYLOAD_REFERENCE_ID_NOT_FOUND | reference_id is not found / reference_id payload is missing|
|500| INTERNAL_SERVER_ERROR         | Internal server error |

But, you can also received error_code in your successful request. This error_code indicates an error that appeared in processing the request from the extract-async method. The following is a list of error_code you might get. <br>

| Error code                    | Description                                  |
|----------------------------------------------|----------------------------------------------|
| FAIL_ON_1 | Fail on quality |
| KTP_NOT_DETECTED              | KTP not detected from image              |
| INTERNAL_SERVER_ERROR         | Internal server error |
<b> Effective 1 Sep 2023 </b>
* Remove response: "blur_score" and "dark_score"

## Query parameters

- `reference_id` string, required

## Headers

- `App-ID` string, required
- `API-Key` string, required

## Response `200`

Successful Response

- ResponseExtractKTPAsyncResult
  - `message` string, required: Message
  - `error_code` string: This error_code indicates an error that appeared in processing the request from the extract-async method
  - `data` object: Show the recognition result
    - `address` string: Shows address from KTP
    - `administrative_village` string: Shows administrative village from KTP
    - `blood_type` string: Shows blood type from KTP
    - `city` string: Shows city from KTP
    - `date_of_birth` string: Shows date of birth from KTP
    - `district` string: Shows district from KTP
    - `full_name` string: Shows full name from KTP
    - `gender` string: Shows gender from KTP
    - `marital_status` string: Shows marital status from KTP
    - `nationality` string: Shows nationality from KTP
    - `nik` string: Shows NIK from KTP
    - `occupation` string: Shows occupation from KTP
    - `place_of_birth` string: Shows place of birth from KTP
    - `religion` string: Shows religion from KTP
    - `rt_rw` string: Shows RT/ RW from KTP
    - `state` string: Shows state from KTP
    - `image_quality` object: Shows quality of image
      - `blur` boolean
      - `dark` boolean
      - `flashlight` boolean
      - `grayscale` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/verihubs/apis/ai-api-documentation.md) - [All operations](https://skmtc.dev/verihubs/apis/ai-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/verihubs/apis/ai-api-documentation/revisions/9313db607e15?raw)