---
title: "List Issues"
method: GET
path: "/issues"
tags: ["Issues"]
---

# List Issues

`GET /issues`

List all issues that have been observed by Terminal.
Issues are generated when we observe something that may impact the completeness or accuracy of the data we provide but do not justify a full error.
For example, if we lack permissions for a specific resource or need to skip an item due to invalid data.

## Query parameters

- `limit` integer
- `cursor` string, cursor
- `lastReportedAfter` string, date-time — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date
- `lastReportedBefore` string, date-time — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date
- `expand` 'connection'
- `connectionId` string, ulid
- `errorCode` 'missing_permissions' | 'exceeded_retention_window' | 'invalid_source_id' | 'unknown_device_type' | 'missing_safety_configuration' | 'inaccessible_data' | 'manually_disabled'
- `status` 'ongoing' | 'resolved'

## Headers

- `X-Application-Id` string

## Response `200`

OK

- object
  - `results` object[], required
    - `id` string, ulid, required
    - `connection` union, required — Entities in Terminal are expandable. Using the `expand` query parameter you can choose to ingest just an ID or the full entity details.
      - string, ulid
      - object
        - `id` string, required
    - `status` 'ongoing' | 'resolved', required
    - `error` object, required
      - `code` 'missing_permissions' | 'exceeded_retention_window' | 'invalid_source_id' | 'unknown_device_type' | 'missing_safety_configuration' | 'inaccessible_data' | 'manually_disabled', required
      - `message` string, required
    - `firstReportedAt` string, date-time, required — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date
    - `lastReportedAt` string, date-time, required — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date
  - `next` string, cursor — Cursor used for pagination.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error
- `504` — Gateway Timeout Error

---

[API](https://skmtc.net/withterminal/apis/terminal-telematics-api.md) · [All operations](https://skmtc.net/withterminal/apis/terminal-telematics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withterminal/terminal-telematics-api/versions/90249c4a1739/schema)