Skip to content
Phone Numbers

Get a phone number's activity

GET/phone-numbers/{id}/activity

How one phone number performs over time: calls placed and received and how many outbound calls someone picked up (its answer rate), per day over the last 30 days, per week over the last 12 weeks or per month over the last 12 months, with every spam-reputation check of the window. A falling answer rate with a rising spam score is the sign a number is getting flagged.

Path parameters

  • idstringrequired

    ID of the phone number record, as returned by GET /phone-numbers (not the phone number itself).

Query parameters

  • granularity"day" | "week" | "month"

    Size of each point: day, week (the default) or month. It also sets the window.

    Default "week"

Request body

No body: send the request without one.

Response

200
  • activityobject

Errors

  • 404Not found in your organization{ "error": string }

Error bodies carry an error (or message) string; a 400 adds bodyErrors.issues. See Errors.