Docs

Overview

Contacts

Topics

Segments

Forms

API Keys

Automations

Broadcasts

Contact Properties

Events

Fire custom eventPOST

Inbox

Marketing Emails

Sending Domains

Transactional Emails

Broadcasts

GET

List Broadcasts

GET /v1/broadcasts

Retrieve a paginated list of all broadcasts in your workspace.

Use Cases:

View all broadcasts and their statuses
Monitor campaign progress
Build broadcast management dashboards
Audit past broadcast campaigns
Track scheduled broadcasts

Behavior:

Returns broadcasts in reverse chronological order (newest first)
Uses cursor-based pagination for efficient retrieval
Includes broadcast metadata, status, and email content summary
Maximum 100 broadcasts per request
Includes all statuses (DRAFT, QUEUED_FOR_SENDING, SENDING, SENT, etc.)

Required Scope: read:broadcasts

Response Includes:

Broadcast ID, name, and status
Sender address and reply-to
Email content (subject, preview text, HTML, text)
Topic and segment associations
Scheduled send time
Creation timestamp

Query parameters

limitinteger

Number of items to return (default: 20, max: 100)

afterstring

Cursor for pagination - ID of the last item from the previous page

beforestring

Cursor for reverse pagination - ID of the first item from the next page

Response

200Successfully retrieved paginated list of broadcasts with metadata and content

objectstringrequired

hasMorebooleanrequired

dataobject[]required

Request

curl -X GET "https://api.kibamail.com/v1/broadcasts" \
  -H "Authorization: Bearer kb_your_api_key" \
  -H "Content-Type: application/json"

Response

Successfully retrieved paginated list of broadcasts with metadata and content

{
  "object": "string",
  "hasMore": true,
  "data": [
    {
      "id": "string",
      "name": "string",
      "status": "string",
      "from": null,
      "emailContent": null,
      "replyTo": null,
      "topicId": null,
      "segmentId": null,
      "sendAt": null,
      "createdAt": "string"
    }
  ]
}

Copyright © 2026 Kibamail.·Privacy Policy