Skip to main content
GET
List a playlist's views

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Unique playlist identifier

Example:

"pl_abc123def456"

Query Parameters

startDate
string

First day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to start from the first recorded view. Without a Premium plan it is required and must be within the last 30 days.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-01-01"

endDate
string

Last day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to run through today.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-01-01"

limit
integer

Views per page (default: 20, max: 100)

Required range: 1 <= x <= 100
Example:

20

cursor
string

Opaque cursor for the next page, from the previous response's pagination.nextCursor

Response

OK

Who watched, newest first

endDate
string | null
required

The endDate that was applied, or null for no upper bound

pagination
object
required

Pagination metadata for list responses. Results are sorted by updatedAt descending.

startDate
string | null
required

The startDate that was applied, or null for no lower bound

views
object[]
required

Views in the range, newest first