Skip to content

Get attribution statistics

GET
/api/v1/attributions/stats
curl --request GET \
--url 'https://example.com/api/v1/attributions/stats?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z&granularity=day' \
--header 'Authorization: Bearer <token>'
from
required
string format: date-time

Start of the period (inclusive), ISO 8601

to
required
string format: date-time

End of the period (exclusive), ISO 8601

granularity
required
string
Allowed values: day week month

Bucket size for the time series

partner_ids
Array<string>

Filter by partner IDs

workspace_ids
Array<string>

Filter by workspace IDs

OK

Media type application/json
object
summary
required
object
total
required
integer
confirmed
required
integer
cancelled
required
integer
buckets
required
Array<object>
object
timestamp
required
string format: date-time
total
required
integer
confirmed
required
integer
cancelled
required
integer
Example generated
{
"summary": {
"total": 1,
"confirmed": 1,
"cancelled": 1
},
"buckets": [
{
"timestamp": "2026-04-15T12:00:00Z",
"total": 1,
"confirmed": 1,
"cancelled": 1
}
]
}

Bad request

Media type application/json
object
error_code
required
string
Allowed values: UNAUTHORIZED NOT_FOUND INTERNAL_ERROR BAD_REQUEST FORBIDDEN CONFLICT
message
required
string
Example
{
"error_code": "UNAUTHORIZED",
"message": "Authentication credentials were not provided or are invalid."
}

Unauthorized

Media type application/json
object
error_code
required
string
Allowed values: UNAUTHORIZED NOT_FOUND INTERNAL_ERROR BAD_REQUEST FORBIDDEN CONFLICT
message
required
string
Example
{
"error_code": "UNAUTHORIZED",
"message": "Authentication credentials were not provided or are invalid."
}

Internal server error

Media type application/json
object
error_code
required
string
Allowed values: UNAUTHORIZED NOT_FOUND INTERNAL_ERROR BAD_REQUEST FORBIDDEN CONFLICT
message
required
string
Example
{
"error_code": "UNAUTHORIZED",
"message": "Authentication credentials were not provided or are invalid."
}