---
title: "List Blasts"
method: POST
path: "/messages/blasts/list"
tags: ["Messages > blasts"]
---

# List Blasts

`POST /messages/blasts/list`

## Request

- Base URL: `https://api.pinnacle.sh`
- URL: `https://api.pinnacle.sh/messages/blasts/list`
- Auth: API key in header `PINNACLE-API-KEY`

List all blasts with optional filtering and pagination. Results are sorted by creation date, newest first.

## Request body

- ListBlastsRequest
  - `pageIndex` integer
  - `pageSize` integer
  - `audienceId` string: Filter blasts by audience ID.
  - `sender` string: Filter blasts that include this sender (phone number or agent ID).
  - `content` string: Search blast content (partial match, case-insensitive).

## Response `200`

Returns paginated list of blasts.

- ListBlastsResponse
  - `data` BlastSummary[], required
    - `id` string, required: Unique identifier for the blast.
    - `audienceId` string, required: Audience ID associated with this blast.
    - `type` 'SMS' | 'MMS' | 'RCS', required: Type of the blast message.
    - `senders` string[], required: Sender identifiers (phone numbers or agent IDs) used for the blast.
    - `content` BlastSummaryContent, required: Message content sent in the blast.
    - `options` BlastSummaryOptions, required: Blast options configuration.
    - `fallback` BlastSummaryFallback, required: Fallback message configuration, if any.
    - `createdAt` string, required: ISO 8601 timestamp of when the blast was created.
  - `hasMore` boolean, required
  - `count` integer, required

## Other responses

- `400`: Validation failed. The payload has missing required fields and/or invalid types. <br> See https://zod.dev/error-formatting for more information.
- `401`: The request lacks valid authentication credentials or the provided credentials are invalid. <br> Ensure you're including a valid API key in the request headers and that your account has the necessary permissions to access this endpoint.
- `500`: An unexpected error occurred on Pinnacle's servers while processing your request. <br> If this error persists, please contact support with the request details.

---

[API](https://skmtc.dev/pinnacle/apis/pinnacle-2.md) - [All operations](https://skmtc.dev/pinnacle/apis/pinnacle-2/llms.txt) - [OpenAPI document](https://skmtc.dev/pinnacle/apis/pinnacle-2/revisions/45416dadab79?raw)