HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get Campaigns

Returns some or all campaigns based on filters.

A channel filter is required to list campaigns. Please provide either:
?filter=equals(messages.channel,'email') to list email campaigns, or
?filter=equals(messages.channel,'sms') to list SMS campaigns.
?filter=equals(messages.channel,'mobile_push') to list mobile push campaigns.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes:
campaigns:read

OpenAPI Spec

Query Params
fields[campaign-message]
array of strings
fields[campaign-message]
fields[campaign]
array of strings
fields[campaign]
fields[tag]
array of strings
fields[tag]
Allowed:
string
required

For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
id: any (string)
messages.channel: equals (allowed values: 'email', 'sms', 'mobile_push')
name: contains (string)
status: any, equals (allowed values: 'Scheduled', 'Sent', 'Draft', 'Cancelled', 'Adding Recipients', 'Sending', 'Variations Sent', 'Sending Segments', 'Cancelled: Smart Sending', 'Preparing to send', 'Cancelled: Account Disabled', 'Cancelled: No Recipients', 'Preparing to schedule', 'Cancelled: Internal Error', 'Queued without Recipients', 'Cancelled: Billing Limit', 'Cancelled: Misconfigured', 'Unknown')
archived: equals (boolean)
created_at: greater-or-equal, greater-than, less-or-equal, less-than (date-time)
scheduled_at: greater-or-equal, greater-than, less-or-equal, less-than (date-time)
updated_at: greater-or-equal, greater-than, less-or-equal, less-than (date-time)

include
array of strings
include
Allowed:
integer
1 to 100
Defaults to 100

Default: 100. Min: 1. Max: 100.

Headers
string
required
Defaults to 2026-07-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json