Read one number

GET

/api/did-monitoring/v1/numbers/{phone}

Returns the result of the last check for one monitored number.

INFO

This request does not use credits. This request does not run a check.

Request

Authorization

Path Params

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad request

🟠401Unauthorized

🟠404Not found

🔴503Service unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.callerapi.com/api/did-monitoring/v1/numbers/+13058901598'

Response Example

200 - Flagged number

{
    "status": "success",
    "data": {
        "phone": "+13058901598",
        "status": "flagged",
        "label": "Spam or scam risk",
        "status_changed_at": "2026-10-29T08:02:11Z",
        "last_checked_at": "2026-10-29T08:02:11Z",
        "next_check_at": "2026-10-30T00:00:00Z"
    }
}

Modified at 2026-10-29 10:41:34

List number status

Remove a number