A metric over time
curl --request GET \
--url https://app.usertick.com/api/public/v1/metrics/timeseries \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.usertick.com/api/public/v1/metrics/timeseries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/metrics/timeseries"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"metric": "responses",
"interval": "day",
"surveyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"points": [
{
"date": "2026-09-30T10:00:00.000Z",
"value": 123,
"count": 123
}
]
}Metrics
Get a metric over time
One point per day, week or month (UTC), oldest first.
Scopes: analytics:read.
GET
/
metrics
/
timeseries
A metric over time
curl --request GET \
--url https://app.usertick.com/api/public/v1/metrics/timeseries \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.usertick.com/api/public/v1/metrics/timeseries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/metrics/timeseries"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"metric": "responses",
"interval": "day",
"surveyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"points": [
{
"date": "2026-09-30T10:00:00.000Z",
"value": 123,
"count": 123
}
]
}Authorizations
bearerAuthapiKeyHeader
An API key (utk_live_...) or an app's OAuth access token (uto_...).
Query Parameters
responses (default), nps or detractors (both need surveyId).
Available options:
responses, nps, detractors day (default), week or month.
Available options:
day, week, month One survey.
From this time (RFC 3339; UTC when no offset).
Up to this time (RFC 3339; UTC when no offset). A date alone (2026-10-14) includes that whole UTC day.