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

# List campaign sends

`GET /campaigns/{id}/sends`

## Request

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

Returns the campaign's send history: the 100 most recent sends, each with aggregate counts (messages generated, attempted and accepted), its status and timestamps, and the carriers it excluded. It is not a per-recipient record. It is 404 when the account has no campaign with the ID.

## Path parameters

- `id` string, required

## Response `200`

OK

- ListCampaignSendsOutput
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` Send[], nullable, required: The campaign's 100 most recent sends.
    - `accepted_count` integer, nullable, required: Messages accepted for delivery, across every pass of the send.
    - `attempted_count` integer, nullable, required: Messages attempted, across every pass of the send.
    - `created_at` integer, required: Creation time in milliseconds since the Unix epoch.
    - `denied_carriers` string[], nullable, required: Carriers excluded from this send; null when none were.
    - `done_at` integer, nullable, required: Finish time in milliseconds since the Unix epoch.
    - `failure_code` string, nullable, required: Why the send failed; same values as failure_code on Campaign.
    - `id` string, required: Send ID.
    - `message_count` integer, nullable, required: Messages generated for the send.
    - `phone_number` string, nullable, required: Sender number used.
    - `scheduled_at` integer, nullable, required: Scheduled start in milliseconds since the Unix epoch.
    - `sent_at` integer, nullable, required: Start time in milliseconds since the Unix epoch.
    - `status` 'created' | 'done' | 'generated' | 'paused' | 'queued' | 'resumed', required: The send's status.
    - `updated_at` integer, required: Last-change time in milliseconds since the Unix epoch.

## Other responses

- `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)