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

# Retrieve attempts

`GET /attempts`

This endpoint lists attempts, or a subset of attempts.

## Query parameters

- `id` union — ID of the attempt
  - string — Attempt ID
  - string[]
- `event_id` union — Event the attempt is associated with
  - string — Event ID
  - string[]
- `order_by` union — Sort key(s)
  - 'created_at'
  - string[]
- `dir` union — Sort direction(s)
  - 'asc' | 'desc'
  - string[]
- `limit` integer — Result set size
- `next` string — The ID to provide in the query to get the next set of results
- `prev` string — The ID to provide in the query to get the previous set of results

## Response `200`

List of attempts

- EventAttemptPaginatedResult
  - `pagination` SeekPagination
    - `order_by` union
      - string
      - string[]
    - `dir` union
      - union
        - 'asc'
        - 'desc'
        - 'ASC'
        - 'DESC'
      - OrderByDirection[]
        - union
          - 'asc'
          - 'desc'
          - 'ASC'
          - 'DESC'
    - `limit` integer
    - `prev` string
    - `next` string
  - `count` integer
  - `models` EventAttempt[]
    - `id` string, required — Attempt ID
    - `team_id` string, required — ID of the project
    - `event_id` string, required — Event ID
    - `destination_id` string, required — Destination ID
    - `response_status` integer, nullable — Attempt's HTTP response code
    - `attempt_number` integer, nullable — Sequential number of attempts (up to and including this one) made for the associated event
    - `trigger` 'INITIAL' | 'MANUAL' | 'BULK_RETRY' | 'UNPAUSE' | 'AUTOMATIC', nullable — How the attempt was triggered
    - `error_code` 'BAD_RESPONSE' | 'CANCELLED' | 'TIMEOUT' | 'NOT_FOUND' | 'CANCELLED_PAST_RETENTION' | 'CONNECTION_REFUSED' | 'CONNECTION_RESET' | 'MISSING_URL' | 'CLI' | 'CLI_UNAVAILABLE' | 'SELF_SIGNED_CERT' | 'ERR_TLS_CERT_ALTNAME_INVALID' | 'ERR_SSL_WRONG_VERSION_NUMBER' | 'NETWORK_ERROR' | 'NETWORK_REQUEST_CANCELED' | 'NETWORK_UNREACHABLE' | 'TOO_MANY_REDIRECTS' | 'INVALID_CHARACTER' | 'INVALID_URL' | 'SSL_ERROR_CA_UNKNOWN' | 'DATA_ARCHIVED' | 'SSL_CERT_EXPIRED' | 'BULK_RETRY_CANCELLED' | 'DNS_LOOKUP_FAILED' | 'HOST_UNREACHABLE' | 'INTERNAL_ERROR' | 'PROTOCOL_ERROR' | 'PAYLOAD_MISSING' | 'UNABLE_TO_GET_ISSUER_CERT' | 'SOCKET_CLOSED' | 'OAUTH2_HANDSHAKE_FAILED' | 'Z_DATA_ERROR' | 'UNKNOWN' — Error code of the delivery attempt
    - `body` union
      - object, nullable — Response body from the destination
      - string, nullable — Response body from the destination
    - `requested_url` string, nullable — URL of the destination where delivery was attempted
    - `http_method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'QUERY', nullable — HTTP method used to deliver the attempt
    - `bulk_retry_id` string, nullable — ID of associated bulk retry
    - `status` 'FAILED' | 'SUCCESSFUL', required — Attempt status
    - `successful_at` string, date-time, nullable — Date the attempt was successful
    - `delivered_at` string, date-time, nullable — Date the attempt was delivered
    - `responded_at` string, date-time, nullable — Date the destination responded to this attempt
    - `delivery_latency` integer, nullable — Time elapsed between attempt initiation and final delivery (in ms)
    - `response_latency` integer, nullable — Time elapsed between attempt initiation and a response from the destination (in ms)
    - `updated_at` string, date-time, required — Date the attempt was last updated
    - `created_at` string, date-time, required — Date the attempt was created

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

## Changes

- **2026-08-22** `dcaf9f9d4ba9` — 1 warning
  - added the new `QUERY` enum value to the `models/items/http_method` response property for the response status `200`
- **2026-08-12** `268542864217` — 1 warning
  - added the new `HEAD` enum value to the `models/items/http_method` response property for the response status `200`

[Change history](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/changes/attempts/get.md)

---

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