List number status

GET

/api/did-monitoring/v1/numbers

Returns all monitored numbers with the result of the last check. Use this request to get the full results for all your numbers. Webhooks send only changes.

Results come in pages. The default page size is 50. The maximum is 100. When next_cursor is not null, send it as cursor to get the next page. Use the same status and list_id for all pages.

INFO

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

Request

Authorization

Query 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?status=&limit=&cursor=&list_id='

Response Example

200 - flagged

{
    "status": "success",
    "data": {
        "counts": {
            "total": 1,
            "flagged": 1,
            "clean": 0,
            "pending": 0,
            "unknown": 0
        },
        "numbers": [
            {
                "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"
            }
        ],
        "next_cursor": null
    }
}

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

Submit numbers

Read one number