---
title: "Retrieve an issue"
method: GET
path: "/issues/{id}"
tags: ["Issues"]
---

# Retrieve an issue

`GET /issues/{id}`

This endpoint retrieves a specific issue.

## Path parameters

- `id` string, required — Issue ID

## Response `200`

A single issue

- union
  - DeliveryIssueWithData — Delivery issue
    - `id` string, required — Issue ID
    - `team_id` string, required — ID of the project
    - `status` 'OPENED' | 'IGNORED' | 'ACKNOWLEDGED' | 'RESOLVED', required — Issue status
    - `opened_at` string, date-time, required — ISO timestamp for when the issue was last opened
    - `first_seen_at` string, date-time, required — ISO timestamp for when the issue was first opened
    - `last_seen_at` string, date-time, required — ISO timestamp for when the issue last occured
    - `last_updated_by` string, nullable — Deprecated, will always be set to null
    - `dismissed_at` string, date-time, nullable — ISO timestamp for when the issue was dismissed
    - `auto_resolved_at` string, date-time, nullable
    - `merged_with` string, nullable
    - `updated_at` string, required — ISO timestamp for when the issue was last updated
    - `created_at` string, required — ISO timestamp for when the issue was created
    - `type` 'delivery', required
    - `aggregation_keys` DeliveryIssueAggregationKeys, required — Keys used as the aggregation keys a 'delivery' type issue
      - `webhook_id` string[], required
      - `response_status` number[], required
      - `error_code` AttemptErrorCodes[], required
    - `reference` DeliveryIssueReference, required — Reference to the event and attempt an issue is being created for.
      - `event_id` string, required
      - `attempt_id` string, required
    - `data` DeliveryIssueData, nullable — Delivery issue data
      - `trigger_event` Event
        - `id` string, required — ID of the event
        - `team_id` string, required — ID of the project
        - `webhook_id` string, required — ID of the associated connection (webhook)
        - `source_id` string, required — ID of the associated source
        - `destination_id` string, required — ID of the associated destination
        - `delivery_group` string, nullable — Delivery group computed from the destination delivery groups config
        - `event_data_id` string, required — ID of the event data
        - `request_id` string, required — ID of the request that created the event
        - `attempts` integer, required — Number of delivery attempts made
        - `last_attempt_at` string, date-time, nullable, required — Date of the most recently attempted retry
        - `next_attempt_at` string, date-time, nullable, required — Date of the next scheduled retry
        - `response_status` integer, nullable — Event status
        - `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
        - `status` 'SCHEDULED' | 'QUEUED' | 'HOLD' | 'SUCCESSFUL' | 'FAILED' | 'CANCELLED', required
        - `successful_at` string, date-time, nullable, required — Date of the latest successful attempt
        - `cli_id` string, nullable, required — ID of the CLI the event is sent to
        - `updated_at` string, date-time, required — Date the event was last updated
        - `created_at` string, date-time, required — Date the event was created
        - `data` EventData, nullable — Event data if included
          - `url` string, required
          - `method` string, required
          - `path` string, nullable, required — Raw path string
          - `query` string, nullable, required — Raw query param string
          - `parsed_query` union, required — JSON representation of query params
            - string, nullable
            - object
          - `headers` union, required — JSON representation of the headers
            - string
            - object
          - `appended_headers` string[] — List of headers that were added by Hookdeck
          - `body` union, required — JSON or string representation of the body
            - string
            - object
            - unknown[]
              - …
          - `is_large_payload` boolean — Whether the payload is considered large payload and not searchable
      - `trigger_attempt` EventAttempt, nullable
        - `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
  - TransformationIssueWithData — Transformation issue
    - `id` string, required — Issue ID
    - `team_id` string, required — ID of the project
    - `status` 'OPENED' | 'IGNORED' | 'ACKNOWLEDGED' | 'RESOLVED', required — Issue status
    - `opened_at` string, date-time, required — ISO timestamp for when the issue was last opened
    - `first_seen_at` string, date-time, required — ISO timestamp for when the issue was first opened
    - `last_seen_at` string, date-time, required — ISO timestamp for when the issue last occured
    - `last_updated_by` string, nullable — Deprecated, will always be set to null
    - `dismissed_at` string, date-time, nullable — ISO timestamp for when the issue was dismissed
    - `auto_resolved_at` string, date-time, nullable
    - `merged_with` string, nullable
    - `updated_at` string, required — ISO timestamp for when the issue was last updated
    - `created_at` string, required — ISO timestamp for when the issue was created
    - `type` 'transformation', required
    - `aggregation_keys` TransformationIssueAggregationKeys, required — Keys used as the aggregation keys a 'transformation' type issue
      - `transformation_id` string[], required
      - `log_level` TransformationExecutionLogLevel[], required
    - `reference` TransformationIssueReference, required — Reference to the event request transformation an issue is being created for.
      - `transformation_execution_id` string, required
      - `trigger_event_request_transformation_id` string, nullable — Deprecated but still found on historical issues
    - `data` TransformationIssueData, nullable — Transformation issue data
      - `transformation_execution` TransformationExecution, required
        - `id` string, required
        - `transformed_event_data_id` string, nullable
        - `original_event_data_id` string, required
        - `transformation_id` string, required
        - `team_id` string, required — ID of the project
        - `webhook_id` string, required — ID of the associated connection (webhook)
        - `log_level` 'debug' | 'info' | 'warn' | 'error' | 'fatal', required — The minimum log level to open the issue on
        - `logs` ConsoleLine[], required
          - `type` 'error' | 'log' | 'warn' | 'info' | 'debug', required
          - `message` string, required
        - `updated_at` string, date-time, required
        - `created_at` string, date-time, required
        - `original_event_data` ShortEventData, nullable — Request data
          - `path` string, required — Request path
          - `query` string, nullable, required — Raw query param string
          - `parsed_query` union, required — JSON representation of query params
            - string, nullable
            - object
          - `headers` union, required — JSON representation of the headers
            - string
            - object
          - `body` union, required — JSON or string representation of the body
            - string
            - object
            - unknown[]
              - …
          - `is_large_payload` boolean, nullable — Whether the payload is considered large payload and not searchable
        - `transformed_event_data` ShortEventData, nullable — Request data
          - `path` string, required — Request path
          - `query` string, nullable, required — Raw query param string
          - `parsed_query` union, required — JSON representation of query params
            - string, nullable
            - object
          - `headers` union, required — JSON representation of the headers
            - string
            - object
          - `body` union, required — JSON or string representation of the body
            - string
            - object
            - unknown[]
              - …
          - `is_large_payload` boolean, nullable — Whether the payload is considered large payload and not searchable
        - `issue_id` string, nullable
      - `trigger_attempt` EventAttempt, nullable
        - `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
  - BackpressureIssueWithData — Backpressure issue
    - `id` string, required — Issue ID
    - `team_id` string, required — ID of the project
    - `status` 'OPENED' | 'IGNORED' | 'ACKNOWLEDGED' | 'RESOLVED', required — Issue status
    - `opened_at` string, date-time, required — ISO timestamp for when the issue was last opened
    - `first_seen_at` string, date-time, required — ISO timestamp for when the issue was first opened
    - `last_seen_at` string, date-time, required — ISO timestamp for when the issue last occured
    - `last_updated_by` string, nullable — Deprecated, will always be set to null
    - `dismissed_at` string, date-time, nullable — ISO timestamp for when the issue was dismissed
    - `auto_resolved_at` string, date-time, nullable
    - `merged_with` string, nullable
    - `updated_at` string, required — ISO timestamp for when the issue was last updated
    - `created_at` string, required — ISO timestamp for when the issue was created
    - `type` 'backpressure', required
    - `aggregation_keys` BackpressureIssueAggregationKeys, required — Keys used as the aggregation keys a 'backpressure' type issue
      - `destination_id` string[], required
      - `delay` IssueTriggerBackpressureDelay[], required
    - `reference` BackpressureIssueReference, required — Reference to the destination backpressure an issue is being created for.
      - `destination_id` string, required
    - `data` BackpressureIssueData, nullable — Backpressure issue data
      - `destination` Destination — Associated [Destination](#destination-object) object
        - `id` string, required — ID of the destination
        - `name` string, required — A unique, human-friendly name for the destination
        - `description` string, nullable — Description of the destination
        - `team_id` string, required — ID of the project
        - `type` 'HTTP' | 'CLI' | 'MOCK_API', required — Type of the destination
        - `config` union — Configuration object for the destination type
          - object — The type config for HTTP. Requires type to be `HTTP`.
            - `url` string, URL, required
            - `rate_limit` number, float, nullable
            - `rate_limit_period` 'second' | 'minute' | 'hour' | 'concurrent', nullable
            - `delivery_groups` DestinationDeliveryGroups, nullable — Delivery groups configuration for this destination
              - …
            - `path_forwarding_disabled` boolean
            - `http_method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', nullable
            - `auth_type` 'HOOKDECK_SIGNATURE' | 'CUSTOM_SIGNATURE' | 'BASIC_AUTH' | 'API_KEY' | 'BEARER_TOKEN' | 'OAUTH2_CLIENT_CREDENTIALS' | 'OAUTH2_AUTHORIZATION_CODE' | 'AWS_SIGNATURE' | 'GCP_SERVICE_ACCOUNT', nullable
            - `auth` union
              - …
          - object — The type config for CLI. Requires type to be `CLI`.
            - `path` string, required — Path for the CLI destination
            - `path_forwarding_disabled` boolean
            - `http_method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', nullable
            - `auth_type` 'HOOKDECK_SIGNATURE' | 'CUSTOM_SIGNATURE' | 'BASIC_AUTH' | 'API_KEY' | 'BEARER_TOKEN' | 'OAUTH2_CLIENT_CREDENTIALS' | 'OAUTH2_AUTHORIZATION_CODE' | 'AWS_SIGNATURE' | 'GCP_SERVICE_ACCOUNT', nullable
            - `auth` union
              - …
          - object — The type config for MOCK_API. Requires type to be `MOCK_API`.
            - `rate_limit` number, float, nullable
            - `rate_limit_period` 'second' | 'minute' | 'hour' | 'concurrent', nullable
            - `delivery_groups` DestinationDeliveryGroups, nullable — Delivery groups configuration for this destination
              - …
            - `path_forwarding_disabled` boolean
            - `http_method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', nullable
            - `auth_type` 'HOOKDECK_SIGNATURE' | 'CUSTOM_SIGNATURE' | 'BASIC_AUTH' | 'API_KEY' | 'BEARER_TOKEN' | 'OAUTH2_CLIENT_CREDENTIALS' | 'OAUTH2_AUTHORIZATION_CODE' | 'AWS_SIGNATURE' | 'GCP_SERVICE_ACCOUNT', nullable
            - `auth` union
              - …
        - `disabled_at` string, date-time, nullable, required — Date the destination was disabled
        - `updated_at` string, date-time, required — Date the destination was last updated
        - `created_at` string, date-time, required — Date the destination was created
  - RequestIssueWithData — Request issue
    - `id` string, required — Issue ID
    - `team_id` string, required — ID of the project
    - `status` 'OPENED' | 'IGNORED' | 'ACKNOWLEDGED' | 'RESOLVED', required — Issue status
    - `opened_at` string, date-time, required — ISO timestamp for when the issue was last opened
    - `first_seen_at` string, date-time, required — ISO timestamp for when the issue was first opened
    - `last_seen_at` string, date-time, required — ISO timestamp for when the issue last occured
    - `last_updated_by` string, nullable — Deprecated, will always be set to null
    - `dismissed_at` string, date-time, nullable — ISO timestamp for when the issue was dismissed
    - `auto_resolved_at` string, date-time, nullable
    - `merged_with` string, nullable
    - `updated_at` string, required — ISO timestamp for when the issue was last updated
    - `created_at` string, required — ISO timestamp for when the issue was created
    - `type` 'request', required
    - `aggregation_keys` RequestIssueAggregationKeys, required — Keys used as the aggregation keys a 'request' type issue
      - `source_id` string[], required
      - `rejection_cause` RequestRejectionCause[], required
    - `reference` RequestIssueReference, required — Reference to the request an issue is being created for.
      - `request_id` string, required
    - `data` RequestIssueData, nullable — Request issue data
      - `request` Request
        - `id` string, required — ID of the request
        - `team_id` string, required — ID of the project
        - `verified` boolean, nullable, required — Whether or not the request was verified when received
        - `original_event_data_id` string, nullable, required — ID of the request data
        - `rejection_cause` 'SOURCE_DISABLED' | 'NO_CONNECTION' | 'VERIFICATION_FAILED' | 'UNSUPPORTED_HTTP_METHOD' | 'UNSUPPORTED_CONTENT_TYPE' | 'UNPARSABLE_JSON' | 'PAYLOAD_TOO_LARGE' | 'INGESTION_FATAL' | 'UNKNOWN', required
        - `ingested_at` string, date-time, nullable, required — The time the request was originally received
        - `source_id` string, required — ID of the associated source
        - `events_count` integer, nullable, required — The count of events created from this request (CLI events not included)
        - `cli_events_count` integer, nullable, required — The count of CLI events created from this request
        - `ignored_count` integer, nullable, required
        - `updated_at` string, date-time, required — Date the event was last updated
        - `created_at` string, date-time, required — Date the event was created
        - `data` ShortEventData, nullable — Request data
          - `path` string, required — Request path
          - `query` string, nullable, required — Raw query param string
          - `parsed_query` union, required — JSON representation of query params
            - string, nullable
            - object
          - `headers` union, required — JSON representation of the headers
            - string
            - object
          - `body` union, required — JSON or string representation of the body
            - string
            - object
            - unknown[]
              - …
          - `is_large_payload` boolean, nullable — Whether the payload is considered large payload and not searchable

## Other responses

- `404` — Not Found

## Changes

- **2026-08-22** `dcaf9f9d4ba9` — 2 warning
  - added the new `QUERY` enum value to the `anyOf[#/components/schemas/DeliveryIssueWithData]/data/trigger_attempt/http_method` response property for the response status `200`
  - added the new `QUERY` enum value to the `anyOf[#/components/schemas/TransformationIssueWithData]/data/trigger_attempt/http_method` response property for the response status `200`
- **2026-08-12** `268542864217` — 2 warning
  - added the new `HEAD` enum value to the `anyOf[#/components/schemas/DeliveryIssueWithData]/data/trigger_attempt/http_method` response property for the response status `200`
  - added the new `HEAD` enum value to the `anyOf[#/components/schemas/TransformationIssueWithData]/data/trigger_attempt/http_method` response property for the response status `200`

[Change history](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/changes/issues/:id/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)