---
title: "List errors"
method: GET
path: "/api/v1/errors"
tags: ["errors"]
---

# List errors

`GET /api/v1/errors`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/errors`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/errors/get.ts> (a function with typed inputs; its response is checked against the schema)

List error groups in a specific environment. Runs that fail are grouped by a fingerprint derived from the error type, message, and stack trace. Filter by task identifier, version, status, search text, and time range.

## Query parameters

- `page` object
  - `size` integer: Number of errors per page. Maximum is 100.
  - `after` string: The ID of the error to start the page after. Sets the pagination direction to forward.
  - `before` string: The ID of the error to start the page before. Sets the pagination direction to backward.
- `filter` ErrorsFilter
  - `taskIdentifier` string[]: The identifier of the task the error belongs to
  - `version` string[]: The worker version the error occurred in
  - `status` string[]: The lifecycle status of the error group
  - `search` string: Free-text search across the error type and message
  - `from` string, date-time: The start of the time range to count occurrences within
  - `to` string, date-time: The end of the time range to count occurrences within
  - `period` string: A relative time range to count occurrences within

## Response `200`

Successful request

- ListErrorsResult
  - `data` ErrorListItem[]
    - `id` string, required: The unique ID of the error group, prefixed with `error_`
    - `fingerprint` string, required: The raw fingerprint the error is grouped by
    - `taskIdentifier` string, required: The identifier of the task the error belongs to
    - `errorType` string, required: The error type or name (e.g. `TypeError`)
    - `errorMessage` string, required: The normalized error message
    - `status` 'unresolved' | 'resolved' | 'ignored', required
    - `count` integer, required: The number of occurrences within the requested time range
    - `firstSeen` string, date-time, required: When the error group was first seen (global)
    - `lastSeen` string, date-time, required: When the error group was last seen (global)
    - `resolvedAt` string, date-time, nullable
    - `ignoredUntil` string, date-time, nullable
  - `pagination` object
    - `next` string: The error ID to start the next page after. Pass it as `page[after]`.
    - `previous` string: The error ID to start the previous page before. Pass it as `page[before]`.

## Other responses

- `400`: Invalid query parameters
- `401`: Unauthorized request

## Changes

- **2026-06-21** `87f56eb19e57`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/errors/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)