Errors

List error issues

GET/api/websites/{websiteId}/errors

Returns a paginated list of error issues for the website, with occurrence and affected visit counts for the selected date range.

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>`.

Path parameters

Name	Type	Description
websiteIdrequired	string	ID of the website.

Query parameters

Name	Type	Description
startAtrequired	integer	Start of the date range as a Unix timestamp in milliseconds.
endAtrequired	integer	End of the date range as a Unix timestamp in milliseconds.
status	enum<string>	Filter by issue status: `unresolved`, `resolved`, or `ignored`. Options: `unresolved`, `resolved`, `ignored`
search	string	Search text used to filter results.
release	string	Filter by release, as set with `data-release` or `captureException`.
environment	string	Filter by environment, as set with `data-environment` or `captureException`.
browser	string	Browser used by the visitor.
urlPath	string	Filter by the page path on which the error occurred.
page	integer	Page number, starting at 1.Default: 1
pageSize	integer	Number of results per page.Default: 25

Responses

200Successful response.

Name	Type	Description
countrequired	number	Number of matching records.
datarequired	object[]	Data returned by the operation.

pagerequired	number	Page number, starting at 1.
pageSizerequired	number	Number of results per page.

200 example

{
  "count": 0,
  "data": [
    {
      "createdAt": "string",
      "fingerprint": "string",
      "firstSeen": "string",
      "groupingVersion": 0,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "lastSeen": "string",
      "occurrences": 0,
      "resolvedAt": "string",
      "status": "unresolved",
      "title": "string",
      "visits": 0,
      "websiteId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "page": 0,
  "pageSize": 0
}

400Invalid request.

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

400 example

{
  "error": {
    "code": "string",
    "message": "string",
    "status": -9007199254740991
  }
}

401Authenticated website access required.

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

401 example

{
  "error": {
    "code": "string",
    "message": "string",
    "status": -9007199254740991
  }
}

404Website, issue, or occurrence not found.

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

404 example

{
  "error": {
    "code": "string",
    "message": "string",
    "status": -9007199254740991
  }
}

Code samples

cURL

curl -X GET 'https://api.example.com/api/websites/{websiteId}/errors?startAt=0&endAt=0' \
  -H 'Authorization: Bearer <token>'

PreviousSave my dashboard NextGet error stats