---
title: "List message errors"
method: GET
path: "/campaigns/{id}/message-errors"
tags: ["Campaigns"]
---

# List message errors

`GET /campaigns/{id}/message-errors`

## Request

- Base URL: `https://api.textla.com/v1`
- URL: `https://api.textla.com/v1/campaigns/{id}/message-errors`
- Auth: HTTP bearer

Returns which recipients of the campaign's message failed and why — the failure category, the contact's number and name — so a customer can clean a list or retry. Results are cursor-paginated: `next_cursor` is null on the last page. It is 404 when the account has no campaign with the ID.

## Path parameters

- `id` string, required

## Query parameters

- `cursor` string: Opaque token from a previous response's next_cursor, to fetch the next page. Omit for the first page.
- `limit` integer: Maximum number of errors to return. Defaults to 100.

## Response `200`

OK

- ListMessageErrorsOutput
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` MessageError[], nullable, required
    - `error_category` 'account_needs_attention' | 'campaign_paused' | 'daily_limit_reached' | 'delivery_failed' | 'flagged_as_spam' | 'invalid_number' | 'message_wont_send' | 'opted_out' | 'rate_limit_hit' | 'registration_required' | 'temporarily_unreachable' | 'unknown' | 'unsupported_country', required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `message_created_at` integer, required
    - `message_id` string, required
    - `to_phone_number` string, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `412`: Precondition Failed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `501`: Not Implemented
- `502`: Bad Gateway
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/textla/apis/textla-api.md) - [All operations](https://skmtc.dev/textla/apis/textla-api/llms.txt) - [OpenAPI document](https://skmtc.dev/textla/apis/textla-api/revisions/473f03350bc1?raw)