---
title: "List transmissions"
method: GET
path: "/api/v1/transmissions"
tags: ["transmissions"]
---

# List transmissions

`GET /api/v1/transmissions`

## Request

- Base URL: `https://api.izap.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.izap.ai/api/v1/transmissions`
- Auth: HTTP bearer

Returns the business's bulk sends, newest first. Archived rows are omitted unless `status=archived` is passed. Optionally filter by any other status.

## Query parameters

- `status` string, nullable
- `limit` integer
- `q` string, nullable: Case-insensitive substring of the name.

## Headers

- `business-id` string, uuid, required

## Response `200`

Successful Response

- ListTransmissionsOut
  - `transmissions` TransmissionStatusOut[], required
    - `transmission_id` string, uuid, required
    - `name` string, required
    - `status` string, required
    - `transmission_type` string, required
    - `template_name` string, nullable, required
    - `total_recipients` integer, required
    - `sent_count` integer, required
    - `failed_count` integer, required
    - `pending_count` integer, required
    - `progress_pct` number, required
    - `scheduled_at` string, date-time, nullable, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `created` string, date-time, nullable
    - `business_id` string, uuid, required
  - `total` integer, required
  - `business_id` string, uuid, required

## Other responses

- `401`: Missing or invalid credentials.
- `403`: The credential is valid but not authorized for this action.
- `404`: The resource, or the business named in the request, does not exist.
- `422`: Validation Error
- `default`: Unexpected error.

---

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