Skip to main content
GET
Get Org Insights Usage Chart

Authorizations

Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

orgId
string<uuid>
required

The organization's unique identifier

Query Parameters

startDate
string<date-time>
required

Start of the chart window (ISO 8601 datetime). Clamped to at most 365 days ago.

endDate
string<date-time>
required

End of the chart window (ISO 8601 datetime). Clamped to now.

granularity
enum<string>
required

Bucket size: day, week, or month

Available options:
day,
week,
month
timezone
string

IANA timezone for bucket boundaries (e.g. America/New_York). Defaults to UTC.

Maximum string length: 64
Pattern: ^[A-Za-z_]+(?:\/[A-Za-z_\-+0-9]+){0,2}$

Response

Default Response

buckets
object[]
required

Time buckets ordered ascending by period

granularity
enum<string>
required

Bucket size used

Available options:
day,
week,
month
truncated
boolean
required

True when the org has more teams than the aggregation limit — buckets cover a partial team set

total_teams
number
required

Actual team count on the org, even when truncated