---
title: "List Attempts"
method: GET
path: "/attempts"
tags: ["Attempts"]
---

# List Attempts

`GET /attempts`

Retrieves a paginated list of attempts.

When authenticated with a Tenant JWT, returns only attempts belonging to that tenant.
When authenticated with Admin API Key, returns attempts across all tenants. Use `tenant_id` query parameter to filter by tenant.

## Query parameters

- `tenant_id` string
- `event_id` string
- `destination_id` string
- `status` 'success' | 'failed'
- `topic` union
  - string
  - string[]
- `time[gte]` string, date-time
- `time[lte]` string, date-time
- `limit` integer
- `next` string
- `prev` string
- `include` union
  - string
  - string[]
- `order_by` 'time'
- `dir` 'asc' | 'desc'

## Response `200`

A paginated list of attempts.

- AttemptPaginatedResult — Paginated list of attempts.
  - `models` Attempt[] — Array of attempt objects.
    - `id` string — Unique identifier for this attempt.
    - `tenant_id` string — The tenant this attempt belongs to.
    - `status` 'success' | 'failed' — The attempt status.
    - `time` string, date-time — Time the attempt was made.
    - `code` string — Response status code or error code.
    - `response_data` object — Response data from the attempt. Only included when include=response_data.
    - `attempt_number` integer — The attempt number (1 for first attempt, 2+ for retries).
    - `manual` boolean — Whether this attempt was manually triggered (e.g., a retry initiated by a user).
    - `event_id` string — The ID of the associated event.
    - `destination_id` string — The destination ID this attempt was sent to.
    - `event` union — The associated event object. Only present when include=event or include=event.data.
      - EventSummary — Event object without data (returned when include=event).
        - `id` string
        - `tenant_id` string — The tenant this event belongs to.
        - `destination_id` string — The destination this event was delivered to.
        - `topic` string
        - `time` string, date-time — Time the event was received.
        - `eligible_for_retry` boolean — Whether this event can be retried.
        - `metadata` object, nullable
      - EventFull — Full event object with data (returned when include=event.data).
        - `id` string
        - `tenant_id` string — The tenant this event belongs to.
        - `destination_id` string — The destination this event was delivered to.
        - `topic` string
        - `time` string, date-time — Time the event was received.
        - `eligible_for_retry` boolean — Whether this event can be retried.
        - `metadata` object, nullable
        - `data` object — The event payload data.
  - `pagination` SeekPagination — Cursor-based pagination metadata for list responses.
    - `order_by` string — The field being sorted on.
    - `dir` 'asc' | 'desc' — Sort direction.
    - `limit` integer — Page size limit.
    - `next` string, nullable — Cursor for the next page of results. Null if no more results.
    - `prev` string, nullable — Cursor for the previous page of results. Null if on first page.

## Other responses

- `401` — Missing or invalid authentication credentials.
- `500` — Unexpected server error.

## Changes

- **2026-02-20** `c36d2dacd201` — 5 info
  - the endpoint scheme security `AdminApiKey` was added to the API
  - the endpoint scheme security `TenantJwt` was added to the API
  - added the media type `application/json` for the response with the status `401`
  - added the non-success response with the status `500`
  - …1 more
- **2026-02-13** `42cbfe519754` — 2 info
  - api operation id `adminListAttempts` removed and replaced with `listAttempts`
  - the endpoint scheme security `AdminApiKey` was removed from the API
- **2026-02-06** `8118009609ed` — 1 warning, 6 info
  - removed the optional property `models/items/delivered_at` from the response with the `200` status
  - added the optional property `models/items/event/oneOf[#/components/schemas/EventFull]/destination_id` to the response with the `200` status
  - added the optional property `models/items/event/oneOf[#/components/schemas/EventFull]/tenant_id` to the response with the `200` status
  - added the optional property `models/items/event/oneOf[#/components/schemas/EventSummary]/destination_id` to the response with the `200` status
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/hookdeck/apis/outpost-api/changes/attempts/get.md)

---

[API](https://skmtc.dev/hookdeck/apis/outpost-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/outpost-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/outpost-api/revisions/c36d2dacd201/schema)