Getting started
Guides
Endpoints
- Accounts
- Broadcasts
- Custom Fields
- Forms
- Subscribers
- Tags
- Email Templates
- Purchases
- Segments
- Sequences
- Webhooks
Broadcasts
List broadcasts
GET
/
v4
/
broadcasts
Copy
Ask AI
curl --request GET \
--url https://api.kit.com/v4/broadcasts \
--header 'X-Kit-Api-Key: <api-key>'
Copy
Ask AI
{
"broadcasts": [
{
"id": 2765,
"publication_id": 2765,
"created_at": "2023-02-17T11:43:55Z",
"subject": "Campaign subject 5",
"preview_text": null,
"description": null,
"content": null,
"public": false,
"published_at": null,
"send_at": null,
"thumbnail_alt": null,
"thumbnail_url": null,
"public_url": null,
"email_address": null,
"email_template": {
"id": 6,
"name": "Text Only"
},
"subscriber_filter": [
{
"all": [
{
"type": "all_subscribers"
}
]
}
]
},
{
"id": 2764,
"publication_id": 2764,
"created_at": "2023-02-17T11:43:55Z",
"subject": "Campaign subject 4",
"preview_text": null,
"description": null,
"content": null,
"public": false,
"published_at": null,
"send_at": null,
"thumbnail_alt": null,
"thumbnail_url": null,
"public_url": null,
"email_address": null,
"email_template": {
"id": 6,
"name": "Text Only"
},
"subscriber_filter": [
{
"all": [
{
"type": "all_subscribers"
}
]
}
]
},
{
"id": 2763,
"publication_id": 2763,
"created_at": "2023-02-17T11:43:55Z",
"subject": "Campaign subject 3",
"preview_text": null,
"description": null,
"content": null,
"public": false,
"published_at": null,
"send_at": null,
"thumbnail_alt": null,
"thumbnail_url": null,
"public_url": null,
"email_address": null,
"email_template": {
"id": 6,
"name": "Text Only"
},
"subscriber_filter": [
{
"all": [
{
"type": "all_subscribers"
}
]
}
]
}
],
"pagination": {
"has_previous_page": false,
"has_next_page": false,
"start_cursor": "WzI3NjVd",
"end_cursor": "WzI3NjNd",
"per_page": 500
}
}
Authorizations
Authenticate API requests via an API Key
Response
200
application/json
Returns a paginated list of all broadcasts for your account (including draft, scheduled, and already sent)
The response is of type object
.
Copy
Ask AI
curl --request GET \
--url https://api.kit.com/v4/broadcasts \
--header 'X-Kit-Api-Key: <api-key>'
Copy
Ask AI
{
"broadcasts": [
{
"id": 2765,
"publication_id": 2765,
"created_at": "2023-02-17T11:43:55Z",
"subject": "Campaign subject 5",
"preview_text": null,
"description": null,
"content": null,
"public": false,
"published_at": null,
"send_at": null,
"thumbnail_alt": null,
"thumbnail_url": null,
"public_url": null,
"email_address": null,
"email_template": {
"id": 6,
"name": "Text Only"
},
"subscriber_filter": [
{
"all": [
{
"type": "all_subscribers"
}
]
}
]
},
{
"id": 2764,
"publication_id": 2764,
"created_at": "2023-02-17T11:43:55Z",
"subject": "Campaign subject 4",
"preview_text": null,
"description": null,
"content": null,
"public": false,
"published_at": null,
"send_at": null,
"thumbnail_alt": null,
"thumbnail_url": null,
"public_url": null,
"email_address": null,
"email_template": {
"id": 6,
"name": "Text Only"
},
"subscriber_filter": [
{
"all": [
{
"type": "all_subscribers"
}
]
}
]
},
{
"id": 2763,
"publication_id": 2763,
"created_at": "2023-02-17T11:43:55Z",
"subject": "Campaign subject 3",
"preview_text": null,
"description": null,
"content": null,
"public": false,
"published_at": null,
"send_at": null,
"thumbnail_alt": null,
"thumbnail_url": null,
"public_url": null,
"email_address": null,
"email_template": {
"id": 6,
"name": "Text Only"
},
"subscriber_filter": [
{
"all": [
{
"type": "all_subscribers"
}
]
}
]
}
],
"pagination": {
"has_previous_page": false,
"has_next_page": false,
"start_cursor": "WzI3NjVd",
"end_cursor": "WzI3NjNd",
"per_page": 500
}
}
Assistant
Responses are generated using AI and may contain mistakes.