KYC user identity

POST

/api/kyc/{phone}

INFO

This endpoint costs €0.30 per lookup

Verify user identity information against mobile network operator records.

Score Values

100: Perfect match - exact match with carrier records

75-99: Strong match - high confidence in data accuracy

50-74: Partial match - some matching elements found

1-49: Weak match - low confidence in data accuracy

0: No match - data exists but does not match

-1: Unknown - carrier has no data for comparison

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://callerapi.com/api/kyc/13146049999' \
--header 'Content-Type: application/json' \
--header 'x-auth;' \
--data-raw '{
    "name": {
        "first_name": "John",
        "middle_name": "Smith",
        "last_name": "Doe"
    },
    "dob": {
        "day": "1",
        "month": "12",
        "year": "1999"
    },
    "address": {
        "street": "Omnia",
        "street_no": "23",
        "unit_no": "11A",
        "city": "Toronto",
        "state": "Ontario",
        "postcode": "M4B1B3",
        "country": "CA"
    },
    "email": "john@callerapi.com"
}'

Response Example

200 - High risk, nothing matches

{
    "kyc_results": {
        "first_name_score": "0",
        "last_name_score": "0",
        "name_score": "0",
        "address_score": "0",
        "city_score": "0",
        "country_score": "0",
        "dob_score": "0",
        "postcode_score": "0",
        "email_score": "-1"
    }
}

Request

Authorization

API Key

Add parameter in header

x-auth

Example:

x-auth: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🔴500Server Error

Modified at 2025-08-08 14:58:02

Online presence

Upload spam reports

KYC user identity

Score Values#

Request

Responses

Score Values