> Revox API docs for developers and AI agents. Index: https://www.getrevox.com/docs/api/llms.txt · Everything in one file: https://www.getrevox.com/docs/api/llms-full.txt · OpenAPI 3.1: https://www.getrevox.com/openapi.json · MCP server: https://www.getrevox.com/mcp
> Base URL https://www.getrevox.com/api · Auth: `Authorization: Bearer $REVOX_API_KEY`

# Get a phone number's activity

`GET https://www.getrevox.com/api/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.

## Request

```bash
curl -X GET "https://www.getrevox.com/api/phone-numbers/6f9a3c1e-2b7d-4e58-9a10-3d2c4b5e6f70/activity" \
  -H "Authorization: Bearer $REVOX_API_KEY"
```

## Path parameters

- `id` (string, required): ID of the phone number record, as returned by [`GET /phone-numbers`](https://www.getrevox.com/docs/api/phone-numbers/get-phone-numbers.md) (not the phone number itself).

## Query parameters

- `granularity` ("day" | "week" | "month", optional, default "week"): Size of each point: day, week (the default) or month. It also sets the window.

## Body

No body: send the request without one.

## Response 200

```json
{
  "activity": {
    "phone_number_id": "6f9a3c1e-2b7d-4e58-9a10-3d2c4b5e6f70",
    "phone_number": "+33612345678",
    "granularity": "day",
    "points": [
      {
        "start": "start",
        "outbound_calls": 1,
        "outbound_connected_calls": 1,
        "inbound_calls": 1
      }
    ],
    "health_checks": [
      {
        "checked_at": "2026-11-05T09:00:00Z",
        "status": "healthy",
        "spam_score": 1
      }
    ]
  }
}
```

- `activity` (object)
  - `activity.phone_number_id` (string): ID of the phone number, as returned by [`GET /phone-numbers`](https://www.getrevox.com/docs/api/phone-numbers/get-phone-numbers.md).
  - `activity.phone_number` (string): The number, in E.164 format.
  - `activity.granularity` ("day" | "week" | "month"): The size of each point.
  - `activity.points` (array of object): One entry per point of the window, oldest first.
    - `activity.points.start` (string): First day of the point, as YYYY-MM-DD (UTC): the day itself, the Monday of the week, or the 1st of the month. Every point of the window is listed, including those without calls.
    - `activity.points.outbound_calls` (integer): Calls dialed from this number that week, each retry counted on its own.
    - `activity.points.outbound_connected_calls` (integer): Of outbound_calls, the dials someone picked up: a person or a phone menu, not a voicemail or call screening. Divide by outbound_calls for the number's answer rate that week.
    - `activity.points.inbound_calls` (integer): Calls received on this number that week.
  - `activity.health_checks` (array of object): Every spam-reputation check of the number during the window, oldest first: how its spam score moved.
    - `activity.health_checks.checked_at` (string): When the check ran (ISO 8601).
    - `activity.health_checks.status` ("unknown" | "healthy" | "warning" | "burned"): Spam reputation this check gave the number.
      - `"unknown"`: Never checked, or the check gave no usable signal. Not a sign the number is clean.
      - `"healthy"`: Spam score under 60, and not flagged by Orange Téléphone.
      - `"warning"`: Spam score from 60 to 70: worth watching, still used like any other number.
      - `"burned"`: Spam score above 70, or flagged as spam by Orange Téléphone: used last in the outbound rotation.
    - `activity.health_checks.spam_score` (number | null): Spam score from 0 to 100 at this check, as in spam_score on the phone number. Null when the check reported none.

## Errors

- `404` Not found in your organization: `{"error":"Not found"}`
- Every status is explained under Errors in https://www.getrevox.com/docs/api.md#errors.