---
title: "Get broadcast job status/results"
method: GET
path: "/v2/chats/broadcast/{jobId}"
tags: ["Chats"]
---

# Get broadcast job status/results

`GET /v2/chats/broadcast/{jobId}`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/chats/broadcast/{jobId}`
- Auth: HTTP bearer

**Auth**: User JWT

Privileged, same as the send route: requires a `B2B Server JWT`, or a
user JWT with `application.appSettings.read` on the app. A plain `App JWT`
or a non-admin user JWT is rejected.

## Path parameters

- `jobId` string, required

## Response `200`

```
{
  ok: true,
  jobId: string,
  state: string,
  progress: { processed: number, total: number } | number,
  result?: {
    ok: true,
    total: number,
    processed: number,
    results: [{ chatName, roomJid?, status: 'sent'|'room_not_found'|'dry_run'|'failed', error? }]
  }
}
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Job not found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

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