Skip to main content
GET
/
api
/
v1
/
errors
List errors
curl -X GET "https://api.trigger.dev/api/v1/errors?filter[status]=unresolved" \
  -H "Authorization: Bearer $TRIGGER_SECRET_KEY"
{
  "data": [
    {
      "id": "error_8f3b2a1c9d4e5f60",
      "fingerprint": "<string>",
      "taskIdentifier": "<string>",
      "errorType": "<string>",
      "errorMessage": "<string>",
      "count": 123,
      "firstSeen": "2023-11-07T05:31:56Z",
      "lastSeen": "2023-11-07T05:31:56Z",
      "resolvedAt": "2023-11-07T05:31:56Z",
      "ignoredUntil": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "next": "error_8f3b2a1c9d4e5f60",
    "previous": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Use your project-specific Secret API key. Will start with tr_dev_, tr_prod, tr_stg, etc.

You can find your Secret API key in the API Keys section of your Trigger.dev project dashboard.

Our TypeScript SDK will default to using the value of the TRIGGER_SECRET_KEY environment variable if it is set. If you are using the SDK in a different environment, you can set the key using the configure function.

import { configure } from "@trigger.dev/sdk";

configure({ accessToken: "tr_dev_1234" });

Query Parameters

​
page
object

Paginate the results. Specify the number of errors per page, and the ID of the error to start the page after or before.

For object fields like page, use the "form" encoding style. For example, to get the next page, use page[after]=error_1234.

​
filter
object

Filter the error groups. Filter by task identifier, version, status, search text, and time range.

For array fields, provide multiple values as a comma-separated list. For example, to get unresolved and ignored errors, use filter[status]=unresolved,ignored.

For the time range, use filter[period] (e.g. filter[period]=7d) or filter[from] / filter[to] with ISO timestamps.

Response

Successful request

​
data
object[]
​
pagination
object