API Reference
中文

Indonesia Income Verification V2.0

Income verification API is suitable for personal income and company information verification in Indonesia. This API is realtime and data will be return immediately based on input parameter value.

API Method

Base URL

API

Request MethodsContent-TypeOutput FormatCharacter Set
POSTapplication/jsonJsonUTF-8

Authentication

ParameterTypeRequired/OptionalNotes
partner_codeStringRequiredTo be assigned by TD
partner_keyStringRequiredTo be assigned by TD

Request Parameter

ParameterTypeRequired/OptionalNotes
nameStringRequiredname
phone_numberStringRequiredOnly 10-13 pure numbers and + signs are supported, starting with +628, 628, 08,8
id_numberStringRequiredId card number, only 16 digits of pure numeric input
id_typeStringRequirednational_id
sexStringStrongly recommended“male” or ”female”
birthdateStringStrongly recommended”YYYY-MM-DD”
packageStringStrongly recommendedType of insurance, example:“JHT,JKK,JKM”,"JHT,JKK,JKM,JPN"

Definition:
JKK: Work-related injury insurance
JKM: Non-work-related accidental death insurance
JHT: Endowment insurance
JPN: Pension (JP)
emailStringStrongly recommendedemail
address_employeeStringStrongly recommendedPersonal address

Response Parameter

ParameterTypeDescriptionNotes
codeIntegerAPI status code
messageStringStatus informationThe specific cause of the exception is displayed when the API is in an abnormal state
sequence_idStringResponse unique codeA unique identifier used to track the record of each request
resultStringResultEnumerated values:
hit
no_record
error
error_messageStringError message Message when result =error, i.e.
Kuota harian Anda telah habis :Your daily quota has been exceeded
Error system: System error
......
dataJSONObjectresult=no_record, do not return this field; result=hit, return this field, JSON format

Details returned by the data field:

ParameterTypeDescriptionNotes
company_infoJSONObjectCompany Information
companyStringCompany namecorrect results
address_companyStringCompany addresscorrect results
belong_bankBooleanThe company belongs to bank or not
listed_companyBooleanThe company is listed in Indonesia or not
fortune_500_companyBooleanIs it a Fortune 500 companySince company names vary from region to region, this field is for reference only.
salary_infoJSONObjectSalary Information
salary_level_regionStringThe salary level of the region
salary_level_age_groupStringThe salary level of the age group
over_average_monthly_salaryBooleanAbove Indonesia average salary or not
month_last_salaryStringLatest salary month received:“mm/yyyy”correct results
range_salaryStringSalary rangecorrect results
sexStringSexmatch/not match
birthdateStringBirthdaymatch/not match
packageStringType of insurancematch/not match
emailStringEmailmatch/not match
address_employeeStringPersonal addressmatch/not match

*If non-required fields are not uploaded, no comparison results are returned

range_salary illustration:

No.RangeMeaning(IDR)
10-2.5JT(0, 2500000)
22.5-3.5JT(2500000,3500000]
33.5-4.5JT(3500000,4500000]
44.5-5.5JT(4500000,5500000]
55.5-6.5JT(5500000,6500000]
66.5-7.5JT(6500000,7500000]
77.5-8.5JT(7500000,8500000]
88.5-10.5JT(8500000,10500000]
910.5-13JT(10500000,13000000]
1013-16JT(13000000,16000000]
1116-20JT(16000000,20000000]
1220-30JT(20000000,30000000]
1330-40JT(30000000,40000000]
1440-55JT(40000000,55000000]
1555-70JT(55000000,70000000]
1670-85JT(70000000,85000000]
1785-100JT(85000000,100000000]
18>100JT(100000000,+)

salary_level_region illustration:

ValueMeaning
M4The salary is at the top in the region
M3The salary is above the middle in the region
M2The salary is around the middle in the region
M1The salary is below the middle in the region
M0The salary is at relatively low in the region

salary_level_age_group illustration:

ValueMeaning
M4The salary is at the top in the age group
M3The salary is above the middle in the age group
M2The salary is around the middle in the age group
M1The salary is below the middle in the age group
M0The salary is at relatively low in the age group

API Status Code

codeMessageDescription
200Success
300Service not purchased or not effectiveService not purchased or not effective
301Service not purchasedService not purchased
302Service has been suspendService has been suspend
303Not enough balanceNot enough balance
304Service expiredService expired
9500Internal errorInternal error
9060{parameter} empty{parameter} empty
9061{parameter} error{parameter} error

Hit Request Example

{
    "code": 200,
    "message": "success",
    "data": {
        "company_info": {
            "company": "PT MAJU MAKMUR",
            "address_company": "JL. SUMUR BANDUNG 23, BANDUNG, JAWA BARAT",
            "listed_company": false,
            "fortune_500_company": false,
            "belong_bank": false
        },
        "salary_info": {
            "package": "MATCH",
            "range_salary": ">20.5JT",
            "month_last_salary": "10/2023",
            "salary_level_region": "M3",
            "salary_level_age_group": "M4",
            "over_average_monthly_salary": true
        },
        "birthday": "NOT MATCH",
        "sex": "NOT MATCH",
        "address_employee": "NOT MATCH",
        "email": "NOT MATCH"
    },
    "result": "hit",
    "sequence_id": "1699272744735016I303********0550"
}

Non-hit Request Example

{
"code": 200,
"result": "no_record",
"sequence_id": "75ccadf47dab4c81a06e6f0da746cd9c"
}

Error Example

{
    "code": 200,
    "result": "error",
    "error_message": "Kuota harian Anda telah habis ",
    "sequence_id": "75ccadf47dab4c81a06e6f0da123cd9c"
}

Failed Example

{
    "code": 301,
    "message": "Service not purchased"
}