---
title: "Search a project's issues"
method: GET
path: "/errors/projects/{id}/issues"
tags: ["Errors"]
---

# Search a project's issues

`GET /errors/projects/{id}/issues`

## Request

- Base URL: `https://realuptime.io/api/v1`
- URL: `https://realuptime.io/api/v1/errors/projects/{id}/issues`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Query parameters

- `q` string
- `release` string
- `status` 'open' | 'resolved' | 'ignored'
- `window` '24h' | '7d' | '30d' | 'all'
- `tag` string
- `sort` 'recent' | 'impact'
- `limit` integer

## Response `200`

A page of issues, exact total, and the drop counters. Each issue carries affected_user_count (distinct users, exact up to MAX_ERROR_ISSUE_TRACKED_USERS) and affected_user_count_capped.

- object
  - `project` object, required
    - `id` string, required
    - `name` string, required
  - `filters` object, required
    - `q` string, nullable, required
    - `release` string, nullable, required
    - `status` string, nullable, required
    - `window` string, required
    - `tag` string, nullable, required
    - `sort` string, required
  - `total` number, required
  - `truncated` boolean, required
  - `issues` object[], required
    - `id` string, required
    - `status` 'open' | 'resolved' | 'ignored', required
    - `title` string, required
    - `affected_user_count` number, required
    - `affected_user_count_capped` boolean, required
  - `retentionDays` number, required
  - `usageThisPeriod` object, required
    - `accepted` number, required
    - `droppedOverQuota` number, required
    - `droppedOverBudget` number, required
    - `droppedProjectCeiling` number, required
    - `droppedRateLimited` number, required
    - `droppedMalformed` number, required
    - `droppedClient` number, required
    - `overageAccepted` number, required

## Other responses

- `400`: An out-of-vocabulary filter value. - `RU-4007` Invalid errors API request: https://realuptime.io/kb/errors/ru-4007
- `401`: Missing, invalid, or revoked API key. - `RU-1001` Missing API credentials: https://realuptime.io/kb/errors/ru-1001 - `RU-1002` Invalid or revoked API key: https://realuptime.io/kb/errors/ru-1002
- `403`: The account does not hold the Errors product. This key is IP-restricted and the request came from outside its allowlist. - `RU-4005` Account does not have realuptime errors: https://realuptime.io/kb/errors/ru-4005 - `RU-1007` API key is restricted to an IP allowlist: https://realuptime.io/kb/errors/ru-1007
- `404`: No such project on this account. - `RU-4006` Errors project or issue not found: https://realuptime.io/kb/errors/ru-4006
- `429`: Per-key rate limit exceeded, a Free account's per-account request budget exceeded, or too many failed authentication attempts. - `RU-2002` API read rate limit exceeded: https://realuptime.io/kb/errors/ru-2002 - `RU-2001` Too many failed authentication attempts: https://realuptime.io/kb/errors/ru-2001

---

[API](https://skmtc.dev/realuptime/apis/realuptime-api-v1.md) · [All operations](https://skmtc.dev/realuptime/apis/realuptime-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/realuptime/apis/realuptime-api-v1/revisions/51e481084700?raw)