Skip to main content
GET
List workspace views

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

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

scope
enum<string>

Which videos' views to list (default: workspace)

Available options:
workspace,
mine
Example:

"workspace"

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