HOhookdeck
Destinations

List Destination Attempts

Changed on

Retrieves a paginated list of attempts scoped to a specific destination.

Returns 404 if the destination does not exist or has been deleted. The attempts of a deleted destination remain available from GET /attempts?destination_id=.

get/tenants/{tenant_id}/destinations/{destination_id}/attempts

Request

  • Base URL
    https://api.outpost.hookdeck.com/2025-07-01
  • Auth
    • HTTP bearer
    • or HTTP bearer

Query parameters

string
OR
string[]

Filter attempts by event ID(s). Use bracket notation for multiple values (e.g., event_id[0]=e1&event_id[1]=e2).

status'success' | 'failed'

Filter attempts by status.

string
OR
string[]

Filter attempts by event topic(s). Use bracket notation for multiple values (e.g., topic[0]=user.created&topic[1]=user.updated).

gtestring date-time

Filter with value >= the specified date-time.

ltestring date-time

Filter with value <= the specified date-time.

gtstring date-time

Filter with value > the specified date-time.

ltstring date-time

Filter with value < the specified date-time.

Filter attempts by event time range using comparison operators.

limitinteger

Number of items per page (1-1000, default 100). A value outside this range, or one that is not an integer, returns a 400.

nextstring

Cursor for the next page of results, from pagination.next of a previous response. Mutually exclusive with prev. A cursor that cannot be read returns a 400.

prevstring

Cursor for the previous page of results, from pagination.prev of a previous response. Mutually exclusive with next. A cursor that cannot be read returns a 400.

string
OR
string[]

Fields to include in the response. Use bracket notation for multiple values (e.g., include[0]=event&include[1]=response_data).

  • event: Include event summary (id, topic, time, eligible_for_retry, metadata)
  • event.data: Include full event with payload data
  • response_data: Include response body and headers
  • destination: Include the destination object, without credentials
order_by'time'

Field to sort by.

dir'asc' | 'desc'

Sort direction.

Response

A paginated list of attempts for the destination.

Example response

{
  "pagination": {
    "order_by": "created_at",
    "dir": "desc",
    "limit": 100,
    "next": "MTcwNDA2NzIwMA=="
  },
  "models": [
    {
      "id": "atm_123",
      "tenant_id": "tnt_123",
      "status": "success",
      "time": "2024-01-01T00:00:05Z",
      "code": "200",
      "response_data": {
        "status_code": 200,
        "body": "{\"status\":\"ok\"}",
        "headers": {
          "content-type": "application/json"
        }
      },
      "attempt_number": 1,
      "latency_ms": 212,
      "event_id": "evt_123",
      "destination_id": "des_456",
      "event": {
        "id": "evt_123",
        "tenant_id": "tnt_123",
        "destination_id": "des_456",
        "topic": "user.created",
        "time": "2024-01-01T00:00:00Z",
        "eligible_for_retry": true,
        "metadata": {
          "source": "crm"
        },
        "data": {
          "user_id": "userid",
          "status": "active"
        }
      },
      "destination": {
        "id": "des_12345",
        "tenant_id": "tenant_123",
        "type": "webhook",
        "filter": {
          "data": {
            "amount": {
              "$gte": 100
            },
            "customer": {
              "tier": "premium"
            }
          }
        },
        "config": {
          "url": "https://my-service.com/webhook/handler"
        },
        "delivery_metadata": {
          "app-id": "my-app",
          "region": "us-east-1"
        },
        "metadata": {
          "internal-id": "123",
          "team": "platform"
        },
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-01-01T00:00:00Z",
        "target": "my-service.com",
        "target_url": "https://my-service.com/webhook/handler"
      }
    }
  ]
}

Changes

  • 245bc66dbe5aRevision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • c7b12e3724c0Revision changes
    • breaking

      the // response's property type changed from no type to object for status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed discriminator from // response property for the response status

    • info

      removed from the // response property oneOf list for the response status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status