NAV undefined
undefined
bash

Magic Replies

Welcome! This page will help you to get started using Iluma's magic replies.

If an endpoint or response status that you want to see is not present, contact us

Bank Name Validator

V1

Example Bank Name Validator Request

curl https://api.iluma.ai/v1/identity/bank_account_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw:
    -H 'x-magic-reply: SUCCESS'

Example Bank Name Validator Response - SUCCESS

{
    "status": "SUCCESS",
    "bank_account_number": "1234567890",
    "bank_code": "BCA",
    "updated": "2017-07-03T10:51:44.484Z",
    "bank_account_holder_name": "FIRA DIYANKA",
    "is_normal_account": true,
    "id": "59e608887eb26d005d44aeb8",
    "reference_id": "foo123"
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, account found SUCCESS Yes
Duplicate request which is waiting for a previous request to complete processing WAITING_ON_BANK No
Completed, account not found FAILED Yes

V1.1

Example Bank Name Validator Request

curl https://api.iluma.ai/v1.1/identity/bank_account_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw:
    -H 'x-magic-reply: COMPLETED_FOUND'

Example Bank Name Validator Response - COMPLETED_FOUND

{
    "status": "COMPLETED",
    "bank_account_number": "1234567890",
    "bank_code": "BCA",
    "created": "2017-07-03T10:51:44.484Z",
    "updated": "2017-07-03T10:51:44.484Z",
    "id": "bknv_5c6ba591cf3c3867d75053d7",
    "reference_id": "foo123",
    "result": {
        "is_found": true,
        "account_holder_name": "FIRA DIYANKA",
        "is_virtual_account": false
    },
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, account found COMPLETED_FOUND Yes
Duplicate request which is waiting for a previous request to complete processing WAITING_ON_BANK No
Completed, account not found COMPLETED_NOT_FOUND Yes
Temporary network error from Iluma side TEMPORARY_NETWORK_ERROR Yes

V1.2

Example Bank Name Validator Request

curl https://api.iluma.ai/v1.2/identity/bank_account_validation_details \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw:
    -H 'x-magic-reply: COMPLETED_FOUND'

Example Bank Name Validator Response - COMPLETED_FOUND

{
    "status": "COMPLETED",
    "bank_account_number": "1234567890",
    "bank_code": "ID_BCA",
    "created": "2017-07-03T10:51:44.484Z",
    "updated": "2017-07-03T10:51:44.484Z",
    "id": "bknv_5c6ba591cf3c3867d75053d7",
    "reference_id": "foo123",
    "result": {
        "is_found": true,
        "account_holder_name": "FIRA DIYANKA",
        "is_virtual_account": false
    },
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, account found COMPLETED_FOUND Yes
Duplicate request which is waiting for a previous request to complete processing WAITING_ON_BANK No
Completed, account not found COMPLETED_NOT_FOUND Yes
Temporary network error from Iluma side TEMPORARY_NETWORK_ERROR Yes

V2

Example Bank Name Validator Request

curl https://api.iluma.ai/v2/identity/bank_account_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw:
    -H 'x-magic-reply: SUCCESS_MATCH'

Example Bank Name Validator Response - SUCCESS_MATCH


{
    "status": "SUCCESS",
    "bank_account_number": "1234567890",
    "bank_code": "BCA",
    "updated": "2017-07-03T10:51:44.484Z",
    "name_matching_result": "MATCH",
    "is_normal_account": true,
    "id": "59e608887eb26d005d44aeb8",
    "reference_id": "foo123"
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, account found and name matches SUCCESS_MATCH Yes
Completed, account found and name doesn't match SUCCESS_NOT_MATCH Yes
Completed, account found and name match is inconclusive SUCCESS_UNCLEAR Yes
Duplicate request which is waiting for a previous request to complete processing WAITING_ON_BANK No
Completed, account not found FAILED Yes

V2.1

Example Bank Name Validator Request

curl https://api.iluma.ai/v2.1/identity/bank_account_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw:
    -H 'x-magic-reply: COMPLETED_FOUND_MATCH'

Example Bank Name Validator Response - COMPLETED_FOUND_MATCH

{
    "status": "COMPLETED",
    "bank_account_number": "1234567890",
    "bank_code": "BCA",
    "created": "2017-07-03T10:51:44.484Z",
    "updated": "2017-07-03T10:51:44.484Z",
    "id": "bknv_5c6ba591cf3c3867d75053d7",
    "reference_id": "foo123",
    "result": {
        "is_found": true,
        "name_matching_result": "MATCH",
        "is_virtual_account": false
    },
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, account found and name matches COMPLETED_FOUND_MATCH Yes
Completed, account found and name doesn't match COMPLETED_FOUND_NOT_MATCH Yes
Completed, account found and name match is inconclusive COMPLETED_FOUND_UNCLEAR Yes
Duplicate request which is waiting for a previous request to complete processing WAITING_ON_BANK No
Completed, account not found COMPLETED_NOT_FOUND Yes
Temporary network error from Iluma side TEMPORARY_NETWORK_ERROR Yes

V2.2

Example Bank Name Validator Request

curl https://api.iluma.ai/v2.2/identity/bank_account_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw:
    -H 'x-magic-reply: COMPLETED_FOUND_MATCH'

Example Bank Name Validator Response - COMPLETED_FOUND_MATCH

{
    "status": "COMPLETED",
    "bank_account_number": "1234567890",
    "bank_code": "ID_BCA",
    "created": "2017-07-03T10:51:44.484Z",
    "updated": "2017-07-03T10:51:44.484Z",
    "id": "bknv_5c6ba591cf3c3867d75053d7",
    "reference_id": "foo123",
    "result": {
        "is_found": true,
        "name_matching_result": "MATCH",
        "is_virtual_account": false
    },
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, account found and name matches COMPLETED_FOUND_MATCH Yes
Completed, account found and name doesn't match COMPLETED_FOUND_NOT_MATCH Yes
Completed, account found and name match is inconclusive COMPLETED_FOUND_UNCLEAR Yes
Duplicate request which is waiting for a previous request to complete processing WAITING_ON_BANK No
Completed, account not found COMPLETED_NOT_FOUND Yes
Temporary network error from Iluma side TEMPORARY_NETWORK_ERROR Yes

Ewallet Validator

V0

Example Ewallet Validator Request

curl https://api.iluma.ai/v0/identity/ewallet_account_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_FOUND'

Example Ewallet Account Validator Response - COMPLETED_FOUND

{
    "id": "490a7d40-83af-4b25-8ead-da2e197be6f3",
    "ewallet_type": "MAGIC",
    "ewallet_account_number": "08222",
    "result": {
        "account_status": "ACTIVE",
        "ewallet_account_name": "FIRA DIYANKA"
    },
    "status": "COMPLETED",
    "is_found": true,
    "updated": "2020-01-03 08:21:27.110718+00:00"
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, account found and data exists COMPLETED_FOUND Yes
Completed, account found and data does not exist COMPLETED_NOT_FOUND Yes

NPWP Validator

V1

Example NPWP Validator Request

curl https://api.iluma.ai/v1/identity/npwp_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_FOUND'

Example NPWP Validator Response - COMPLETED_FOUND

{
  "id": "123e4567-e89b-12d3-a456-426655440000",
  "created": "2017-07-03T10:51:44.484Z",
  "updated": "2017-07-03T10:51:44.484Z",
  "account_number": "999999999999999",
  "status": "COMPLETED",
  "is_found": true,
  "result":{
    "account_name": "FIRA DIYANKA"
  }
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, NPWP found COMPLETED_FOUND Yes
Completed, NPWP not found COMPLETED_NOT_FOUND Yes

KTP Validator (ID Card Verifications)

V0

Example KTP Validator Request

curl https://api.iluma.ai/v0/identity/id_card_verifications \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_FOUND'

Example KTP Validator Response - COMPLETED_FOUND

{
    "id": "idvr_33ccb329-c736-4d29-bf65-8eb0820d5abd",
    "created": "2022-10-21T06:16:43.338Z",
    "updated": "2022-10-21T06:16:43.338Z",
    "id_card_number": "3374106101000001",
    "name": "SUSI",
    "birthdate": "30-01-2000",
    "birthplace": "JAKARTA",
    "address": "VICTORIA",
    "status": "COMPLETED",
    "is_found": true,
    "result": {
        "is_name_match": true,
        "is_birthdate_match": true,
        "is_birthplace_match": true,
        "is_address_match": true
    }
}

Example KTP Validator Response - COMPLETED_NOT_FOUND

{
    "id": "idvr_33ccb329-c736-4d29-bf65-8eb0820d5abd",
    "created": "2022-10-21T06:16:43.338Z",
    "updated": "2022-10-21T06:16:43.338Z",
    "id_card_number": "3374106101000001",
    "name": "SUSI",
    "birthdate": "30-01-2000",
    "birthplace": "JAKARTA",
    "address": "VICTORIA",
    "status": "COMPLETED",
    "is_found": false
}
Request status x-magic-reply Callback sent
Completed, NIK found COMPLETED_FOUND No
Completed, NIK not found COMPLETED_NOT_FOUND No

KTP Biometrics

V1

Example KTP Biometrics Request

curl https://api.iluma.ai/v1/identity/id_card_verifications \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_VERIFIED'

Example KTP Biometrics Response - COMPLETED_VERIFIED

{
    "id": "4ec883ab-4629-4acf-a52b-09ab3b90bfbc",
    "created": "2023-06-14T02:43:36.022Z",
    "updated": "2023-06-14T02:43:36.022Z",
    "id_card_number": "3374101233000000",
    "name": "TEST",
    "birthdate": "01-01-2000",
    "phone": "08123213823",
    "email": "test@test.com",
    "status": "COMPLETED",
    "is_verified": true
}

Example KTP Biometrics Response - COMPLETED_UNVERIFIED

{
    "id": "4ec883ab-4629-4acf-a52b-09ab3b90bfbc",
    "created": "2023-06-14T02:43:36.022Z",
    "updated": "2023-06-14T02:43:36.022Z",
    "id_card_number": "3374101233000000",
    "name": "TEST",
    "birthdate": "01-01-2000",
    "phone": "08123213823",
    "email": "test@test.com",
    "status": "COMPLETED",
    "is_verified": false,
    "failure_reason": "Selfie Not Match"
}

Example KTP Biometrics Response - FAILED

{
    "id": "4ec883ab-4629-4acf-a52b-09ab3b90bfbc",
    "created": "2023-06-14T02:43:36.022Z",
    "updated": "2023-06-14T02:43:36.022Z",
    "id_card_number": "3374101233000000",
    "name": "TEST",
    "birthdate": "01-01-2000",
    "phone": "08123213823",
    "email": "test@test.com",
    "status": "FAILED",
    "is_verified": false,
    "failure_reason": "TEMPORARY_NETWORK_ERROR"
}
Request status x-magic-reply Callback sent
Completed, KTP Data is verified COMPLETED_VERIFIED No
Completed, KTP Data is not verified COMPLETED_UNVERIFIED No
Failed, Process is failed COMPLETED_UNVERIFIED No

CFT (Combating the Financing of Terrorism)

V2

Example CFT Request

curl https://api.iluma.ai/v2/identity/cft/individual_data_requests \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_NOT_FOUND'
Request status x-magic-reply Callback sent
Completed, search returned some results COMPLETED_FOUND No
Completed, search returned no results COMPLETED_NOT_FOUND No

CFT + PEP (Combating the Financing of Terrorism plus PEP)

V0

Example Request

curl https://api.iluma.ai/v0/identity/individual_cft_peps \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_NOT_FOUND'
    -d '{
        "given_names": "Eko Hadi Salim",
        "nationality": "ID",
        "score_threshold": 90,
        "scopes": ["PEP"]
    }'

Example Response - COMPLETED_NOT_FOUND

{
    "created": "2022-02-10T18:55:02.061Z",
    "updated": "2022-02-10T18:55:02.840Z",
    "id": "cftpi_05e27fc2-ac76-4307-9f46-36179abb7a6d",
    "reference_id": null,
    "user_id": "123",
    "phone_number": null,
    "email": null,
    "addresses": [],
    "scopes": [
        "PEP"
    ],
    "score_threshold": 90,
    "status": "COMPLETED",
    "given_names": "Eko Hadi Salim",
    "surname": null,
    "nationality": "ID",
    "date_of_birth": null,
    "gender": null,
    "results": []
}
Request status x-magic-reply Callback sent
Completed, search returned some results COMPLETED_FOUND No
Completed, search returned no results COMPLETED_NOT_FOUND No
Failed FAILED No

ID card OCR

V1

Example ID card OCR Request

curl https://api.iluma.ai/v1/identity/id_card_images \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_SUCCESS'

Example ID Card OCR Response - COMPLETED_SUCCES

{
  "id": "f95ae802-4d96-4066-ada7-fe9487d4ca5e",
  "data": {
    "nik": "1234567890123456",
    "name": "FIRA DIYANKA",
    "religion": "KRISTEN",
    "gender": "LAKI-LAKI",
    "birthPlaceBirthday": "JAKARTA,17-10-1975",
    "province": "JAWA TENGAH",
    "city": "KABUPATEN JEPARA",
    "district": "KELING",
    "village": "KELET",
    "rtrw": "015/004",
    "address":"JL. VETERAN GG. GARUDA NO.73D/34",
    "occupation": "KARYAWAN SWASTA",
    "expiryDate": "12-08-2016",
    "nationality": "WNI",
    "maritalStatus":"BELUM KAWIN"
  },
  "status": "COMPLETED",
  "created": "2021-02-19T06:50:25.619Z",
  "updated": "2021-02-19T06:50:25.619Z",
  "type": "indonesia_ktp"
}
Request status x-magic-reply Callback sent
Request submitted but no data yet returned PENDING No
Completed, OCR returned some text COMPLETED_SUCCESS Yes
Completed, no data was able to be read COMPLETED_NO_TEXT Yes
Request failed due to technical error FAILED Yes

Face Comparison

V1

Example Face Comparison Request

curl https://api.iluma.ai/v1/identity/face_comparisons \
    -X POST \
    -u iluma_development_FX4f0M5sxDgk5qFyZnk60ZengAfA9o31x3ecd29vihjc4VhyJ8FclZhHjjw: \
    -H 'x-magic-reply: COMPLETED_MATCH'

Example Face Comparison Response - COMPLETED_MATCH

{
  "status": "COMPLETED",
  "match_percentage": 97.5,
  "id": "5ba359137f94918d2b0cb8bb"
}
Request status x-magic-reply Callback sent
Completed, face comparison returned likely match COMPLETED_MATCH No
Completed, face comparison returned no match COMPLETED_NOT_MATCH No
Request failed due to technical error FAILED No
bash