Phone Check - Dojah Inc

curl --request GET \
  "https://api.dojah.io/api/v1/fraud/phone?phone=2348101234567" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "phone": "2348101234567",
});

const url = "https://api.dojah.io/api/v1/fraud/phone?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/fraud/phone",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={
        "phone": "2348101234567",
    },
)
data = res.json()

{
  "entity": {
    "phone": "2348101234567",
    "valid": true,
    "information": {
      "type": "Wireless",
      "carrier": "MTN Nigeria",
      "country": "NG",
      "city": "N/A",
      "zipcode": "N/A",
      "region": "Nigeria",
      "dialing_code": 234,
      "mnc": "12",
      "mcc": "123",
      "time_zone": "Africa/Lagos"
    },
    "format": {
      "formatted": "+2348101234567",
      "local": "0810 123 4567"
    },
    "risk_score": 0,
    "leaked": false,
    "spammer": false,
    "disposable": false,
    "suspicious": false,
    "recent_abuse": false,
    "active": true,
    "active_status": "N/A"
  }
}

GET/api/v1/fraud/phone

Screen a phone number for risk before you onboard or approve a high-value action — carrier, country, line type and fraud signals in one call.

Headers

Header	Required	Description
`Authorization`	Yes	Your app’s secret key, sent as-is — not `Bearer`.
`AppId`	Yes	The App ID from your dashboard.

Query parameters

Parameter	Type	Required	Description
`phone`	string	Yes	The phone number to screen (international format recommended).

Response

Returns an entity with a valid flag, carrier and country information, the number’s format, a risk_score, and fraud flags — leaked, spammer, disposable, suspicious, recent_abuse and active.

Errors

Code	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — check your key and `AppId` (no `Bearer` prefix).
`402`	Insufficient wallet balance. Fund your wallet.
`404`	No record found for the supplied identifier.
`429`	Too many requests — back off and retry.

curl --request GET \
  "https://api.dojah.io/api/v1/fraud/phone?phone=2348101234567" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "phone": "2348101234567",
});

const url = "https://api.dojah.io/api/v1/fraud/phone?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/fraud/phone",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={
        "phone": "2348101234567",
    },
)
data = res.json()

{
  "entity": {
    "phone": "2348101234567",
    "valid": true,
    "information": {
      "type": "Wireless",
      "carrier": "MTN Nigeria",
      "country": "NG",
      "city": "N/A",
      "zipcode": "N/A",
      "region": "Nigeria",
      "dialing_code": 234,
      "mnc": "12",
      "mcc": "123",
      "time_zone": "Africa/Lagos"
    },
    "format": {
      "formatted": "+2348101234567",
      "local": "0810 123 4567"
    },
    "risk_score": 0,
    "leaked": false,
    "spammer": false,
    "disposable": false,
    "suspicious": false,
    "recent_abuse": false,
    "active": true,
    "active_status": "N/A"
  }
}