Query phone number attributes

Receives a phone number and user consent, and returns various attributes for the given number. An empty object is returned for any attributes that have no information.

post/number-risk-score/1/query

Request

Base URL
https://api.infobip.com (the document declares no server; this is the origin it was published from)
Auth
- OAuth 2
  Client credentials
  Token URL: https://api.infobip.com/auth/1/oauth2/token
- or API key in header Authorization
- or API key in header Authorization
- or HTTP basic

Request body

phoneNumberstring required

Phone number in international format (e.g., +1234567890). Must be between 5 and 15 digits, allowing an optional leading plus sign (+).

consentGrantedboolean required

Indicates whether the user of the mobile phone number has granted consent to perform a request. Must be true.

Example request

{
  "phoneNumber": "+1234567890",
  "consentGranted": true
}

Response

Successful response

status'OK' | 'NO_DATA' required

Status of the response, depending on the data availability

riskLevel'LOW' | 'MEDIUM' | 'HIGH' | 'UNKNOWN' nullable required

Risk level for given time frame

requestIdstring required

A unique request identifier

trustedInteractionboolean nullable

Indicator whether or not number had trusted interactions.

botLikeBehaviorboolean nullable

Indicator whether or not number had bot like behavior.

Example response

{
  "status": "OK",
  "requestId": "667a35d6-d802-4439-9d69-15e272ad558f",
  "carrierInfo": {
    "originalNetwork": {
      "networkName": "T-Mobile",
      "networkPrefix": "99",
      "countryName": "Croatia",
      "countryPrefix": "385"
    },
    "lineType": "MOBILE"
  },
  "tenure": {
    "firstSeen": "2025-01-15",
    "lastSeen": "2025-03-20"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.