# Reported SMS outcomes

`GET /api/v1/phone/feedback/summary`

- Authentication: Secret API key as a bearer token
- Billing: Free.
- Group: Phone

The last 90 days of outcomes you reported: totals per outcome, how many distinct numbers they cover, and the ten blocks (region plus the first six digits of the national number) with the most failed deliveries, with their delivered and abused counts alongside. A bad list or a wholesaler's range shows up here first.

## Example request

```bash
curl https://spaw.co/api/v1/phone/feedback/summary \
  -H "Authorization: Bearer sk_live_…"
```

## Responses

### 200 — The summary.

```json
{
    "success": true,
    "data": {
        "window_days": 90,
        "total": 3120,
        "numbers": 2870,
        "outcomes": {
            "delivered": 2988,
            "undelivered": 121,
            "abused": 11
        },
        "top_undelivered_blocks": [
            {
                "country": "US",
                "block": "201201",
                "undelivered": 38,
                "delivered": 2,
                "abused": 4
            },
            {
                "country": "GB",
                "block": "770090",
                "undelivered": 12,
                "delivered": 0,
                "abused": 0
            }
        ]
    }
}
```

### 401 — The key is missing, malformed, or revoked.

```json
{
    "success": false,
    "error": {
        "code": "UNAUTHENTICATED",
        "message": "Provide a valid API key as a bearer token.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}
```

### 429 — Over 5 requests per second for the key. Retry after the limit resets.

```json
{
    "success": false,
    "error": {
        "code": "RATE_LIMITED",
        "message": "Too many requests. Retry after the limit resets.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}
```

## Error codes

- `UNAUTHENTICATED` — https://spaw.co/docs/errors/UNAUTHENTICATED
- `RATE_LIMITED` — https://spaw.co/docs/errors/RATE_LIMITED

---

Canonical page: https://spaw.co/docs/api/phone-feedback-summary · OpenAPI document: https://spaw.co/openapi.json · All endpoints: https://spaw.co/docs/api