v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-102991198.1 KB
Destinations

List Destination Attempts

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

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

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 (default 100, max 1000).

nextstring

Cursor for next page of results.

prevstring

Cursor for previous page of results.

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 full destination object
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,
      "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_webhook_123",
        "type": "webhook",
        "topics": [
          "user.created",
          "order.shipped"
        ],
        "disabled_at": null,
        "created_at": "2024-02-15T10:00:00Z",
        "updated_at": "2024-02-15T10:00:00Z",
        "config": {
          "url": "https://my-service.com/webhook/handler"
        },
        "credentials": {
          "secret": "whsec_abc123def456",
          "previous_secret": "whsec_prev789xyz012",
          "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
        }
      }
    }
  ]
}