Websites

Get the website's available date range

GET/api/websites/{websiteId}/daterange

Returns the earliest and latest recorded event dates for the website.

Try it

Headers

Name	Type	Description
Authorizationrequired	string	Token returned by POST /api/auth/login, or an API key (`umami_…`) created under Settings → API keys (self-hosted only). `Bearer <token>`.
x-umami-share-contextrequired	string	Required context header when authenticating with a share token. `<api-key>`.
x-umami-share-tokenrequired	string	Signed token returned by a share endpoint. `<api-key>`.

Path parameters

Name	Type	Description
websiteIdrequired	string	ID of the website.

Responses

200The operation completed successfully.

Name	Type	Description
endDaterequired	string	End of the date range as an ISO 8601 date or date-time.
startDaterequired	string	Start of the date range as an ISO 8601 date or date-time.

200 example

{
  "endDate": "2024-01-15T09:30:00Z",
  "startDate": "2024-01-15T09:30:00Z"
}

401Unauthorized.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

401 example

{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized.",
    "status": 401
  }
}

Code samples

cURL

curl -X GET 'https://api.example.com/api/websites/{websiteId}/daterange' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-umami-share-context: <api-key>' \
  -H 'x-umami-share-token: <api-key>'

PreviousGet visitor charts for websites NextExport website analytics