List campaigns

get

https://api.ads.roku.com/v1/developer/campaigns

Returns a list of campaigns.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

account_uid

array of strings

A comma-separated list of account unique identifiers to filter the list of campaigns by.

account_uid

filter

string

The expression to filter campaigns.

Supported fields: status, updated_at.

Key-value pairs are separated by a colon and multiple filter queries can be joined by AND/OR statements. The boolean operators are case sensitive. Date range filters use ISO 8601 format.

Examples:

status:active returns campaigns with status active.

status:active OR status:scheduled returns campaigns with status active or scheduled.

updated_at:[2026-01-01T00:00:00 TO *] returns campaigns modified after the given date.

updated_at:[2026-01-01T00:00:00 TO 2026-01-31T23:59:59] returns campaigns modified within the given date range.

uid

array of strings

A set of unique identifiers to retrieve.

uid

limit

number

≥ 1

The maximum number of results you want to get. Default: 20.

offset

number

≥ 0

Start at the n+1 th result. Use in conjunction with limit to get a specific set of results. For example, a limit of 2 and an offset of 10 returns items 11-12. Default: 0.

order

string

Field to sort by. Use (+/-) to signify ASC/DESC. Default is (+) if no symbol provided.

Example: +created_at.

Supported fields: updated_at, name, created_at.

Default: -updated_at.

Responses

200Success. Returns a list of campaigns along with a count and total_count which indicate the number of campaigns received and number of campaigns available, respectively.

401Unauthorized error

403Forbidden error

422Unprocessable entity error

500Internal server error