--- title: "Retrieve issues" method: GET path: "/issues" tags: ["Issues"] --- # Retrieve issues `GET /issues` This endpoint lists issues, or a subset of issues. ## Query parameters - `id` union — Filter by Issue IDs - string - string[] - `issue_trigger_id` union — Filter by Issue trigger IDs - string — Issue trigger ID - string[] - `type` union — Filter by Issue types - 'delivery' | 'transformation' | 'backpressure' | 'request' — Issue type - string[] - `status` union — Filter by Issue statuses - 'OPENED' | 'IGNORED' | 'ACKNOWLEDGED' | 'RESOLVED' — Issue status - string[] - `merged_with` union — Filter by Merged Issue IDs - string — Issue ID - string[] - `aggregation_keys` object — Filter by aggregation keys - `webhook_id` union - string - string[] - `response_status` union - number, float - number[] - `error_code` union - '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 - AttemptErrorCodes[] - `transformation_id` union - string - string[] - `log_level` union - 'debug' | 'info' | 'warn' | 'error' | 'fatal' - string[] - `destination_id` union - string - string[] - `delay` union - number, float - number[] - `source_id` union - string - string[] - `rejection_cause` union - 'SOURCE_DISABLED' | 'NO_CONNECTION' | 'VERIFICATION_FAILED' | 'UNSUPPORTED_HTTP_METHOD' | 'UNSUPPORTED_CONTENT_TYPE' | 'UNPARSABLE_JSON' | 'PAYLOAD_TOO_LARGE' | 'INGESTION_FATAL' | 'UNKNOWN' - RequestRejectionCause[] - `created_at` union — Filter by created dates - string, date-time, nullable - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `first_seen_at` union — Filter by first seen dates - string, date-time, nullable - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `last_seen_at` union — Filter by last seen dates - string, date-time, nullable - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `dismissed_at` union — Filter by dismissed dates - string, date-time, nullable - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `order_by` union — Sort key(s) - 'created_at' | 'first_seen_at' | 'last_seen_at' | 'opened_at' | 'status' - 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 issues - IssueWithDataPaginatedResult - `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` IssueWithData[] - 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 - … - `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 - … - `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 - … - `updated_at` string, date-time, required - `created_at` string, date-time, required - `original_event_data` ShortEventData, nullable — Request data - … - `transformed_event_data` ShortEventData, nullable — Request data - … - `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 - … - `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 - … - `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 - … ## Other responses - `400` — Bad Request - `422` — Unprocessable Entity --- [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)