HOhookdeck
Attempts

Retrieve an attempt

Changed on

This endpoint retrieves a specific attempt. When retrieving a completed attempt, the response will contain the body of the destination's response. If the body is not yet available in our backend service the body will be set to NOT_AVAILABLE_YET.

get/attempts/{id}

Request

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

Path parameters

idstring required

Attempt ID

Response

A single attempt

idstring required

Attempt ID

team_idstring required

ID of the project

event_idstring required

Event ID

destination_idstring required

Destination ID

response_statusinteger nullable

Attempt's HTTP response code

attempt_numberinteger 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' | 'CLI_BINARY_UNSUPPORTED' | '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

requested_urlstring 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_idstring nullable

ID of associated bulk retry

status'FAILED' | 'SUCCESSFUL' required

Attempt status

successful_atstring date-time nullable

Date the attempt was successful

delivered_atstring date-time nullable

Date the attempt was delivered

responded_atstring date-time nullable

Date the destination responded to this attempt

delivery_latencyinteger nullable

Time elapsed between attempt initiation and final delivery (in ms)

response_latencyinteger nullable

Time elapsed between attempt initiation and a response from the destination (in ms)

updated_atstring date-time required

Date the attempt was last updated

created_atstring date-time required

Date the attempt was created

Changes

  • 9bebff6c68f9Revision changes
    • warning

      added the new CLI_BINARY_UNSUPPORTED enum value to the response property for the response status

  • dcaf9f9d4ba9Revision changes
    • warning

      added the new QUERY enum value to the response property for the response status