---
title: "Sandbox - Get Extract Async"
method: GET
path: "/ktp/id/extract-async/result"
tags: ["KTP"]
---

# Sandbox - Get Extract Async

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

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> reference_id code with _V (e.g REFERENCE_ID_KTP_B_V) means the quality validation is on. 

  |reference_id|Description|
  |-----|-----------|
  |REFERENCE_ID_KTP|Valid reference_id and KTP photo|
  |REFERENCE_ID_KTP_B|Valid reference_id and KTP photo in blur condition|
  |REFERENCE_ID_KTP_D|Valid reference_id and KTP photo in dark condition|
  |REFERENCE_ID_KTP_BD|Valid reference_id and KTP photo in blur and dark condition|
  |REFERENCE_ID_KTP_F|Valid reference_id and KTP photo in flashlight condition|
  |REFERENCE_ID_KTP_G|Valid reference_id and KTP photo in grayscale condition|
  |REFERENCE_ID_KTP_FG|Valid reference_id and KTP photo in flashlight and grayscale condition|
  |REFERENCE_ID_KTP_DG|Valid reference_id and KTP photo in dark and grayscale condition|
  |REFERENCE_ID_KTP_BF|Valid reference_id and KTP photo in blur and flashlight condition|
  |REFERENCE_ID_KTP_BG|Valid reference_id and KTP photo in blur and grayscale condition|
  |REFERENCE_ID_KTP_B_V|Valid reference_id and KTP photo in blur condition with validation_quality|
  |REFERENCE_ID_KTP_D_V|Valid reference_id and KTP photo in dark condition with validation_quality|
  |REFERENCE_ID_KTP_BD_V|Valid reference_id and KTP photo in blur and dark condition with validation_quality|
  |REFERENCE_ID_KTP_F_V|Valid reference_id and KTP photo in flashlight condition with validation_quality|
  |REFERENCE_ID_KTP_G_V|Valid reference_id and KTP photo in grayscale condition with validation_quality|
  |REFERENCE_ID_KTP_FG_V|Valid reference_id and KTP photo in flashlight and grayscale condition with validation_quality|
  |REFERENCE_ID_KTP_DG_V|Valid reference_id and KTP photo in dark and grayscale condition with validation_quality|
  |REFERENCE_ID_KTP_BF_V|Valid reference_id and KTP photo in blur and flashlight condition with validation_quality|
  |REFERENCE_ID_KTP_BG_V|Valid reference_id and KTP photo in blur and grayscale condition with validation_quality|
  |REFERENCE_ID_NOT_FOUND|reference_id not found|
  |REFERENCE_ID_KTP_NOT_DETECTED|reference_id and KTP photo not detected|
  |REFERENCE_ID_TOO_LONG|reference_id is too long|
  |REFERENCE_ID_TOO_SHORT|reference_id is too short|
  

You will receive a response of your payload request which consists of message and an error code if the request process failed. The following table describes choice of image to be used as input.
  

|Error Status|  Error code  |Description          |
|---------------| ------------------------------|----------------------------------------------|
| 400 | INVALID_SANDBOX_CODE              | reference_id not exist in reference_id code sandbox  |
|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 receive 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 | <br>

## 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.net/verihubs/apis/sms-api-documentation.md) · [All operations](https://skmtc.net/verihubs/apis/sms-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verihubs/sms-api-documentation/versions/5fa885d38adc/schema)