---
title: "Retrieve an event delivery"
method: GET
path: "/v1/projects/{projectID}/eventdeliveries/{eventDeliveryID}"
tags: ["Event Deliveries"]
---

# Retrieve an event delivery

`GET /v1/projects/{projectID}/eventdeliveries/{eventDeliveryID}`

This endpoint fetches an event delivery.

## Path parameters

- `projectID` string, required
- `eventDeliveryID` string, required

## Response `200`

OK

- object
  - `message` string
  - `status` boolean
  - `data` ModelsEventDeliveryResponse
    - `acknowledged_at` string
    - `cli_metadata` DatastoreCLIMetadata
      - `event_type` string
      - `source_id` string
    - `created_at` string
    - `deleted_at` string
    - `description` string
    - `device_id` string
    - `device_metadata` DatastoreDevice
      - `created_at` string
      - `deleted_at` string
      - `endpoint_id` string
      - `host_name` string
      - `last_seen_at` string
      - `project_id` string
      - `status` 'offline' | 'online' | 'disabled'
      - `uid` string
      - `updated_at` string
    - `endpoint_id` string
    - `endpoint_metadata` DatastoreEndpoint
      - `advanced_signatures` boolean
      - `authentication` DatastoreEndpointAuthentication
        - `api_key` DatastoreApiKey
          - `header_name` string
          - `header_value` string
        - `type` 'api_key'
      - `created_at` string
      - `deleted_at` string
      - `description` string
      - `events` integer
      - `failure_rate` number
      - `http_timeout` integer
      - `name` string
      - `owner_id` string
      - `project_id` string
      - `rate_limit` integer
      - `rate_limit_duration` integer
      - `secrets` DatastoreSecret[]
        - `created_at` string
        - `deleted_at` string
        - `expires_at` string
        - `uid` string
        - `updated_at` string
        - `value` string
      - `slack_webhook_url` string
      - `status` 'active' | 'inactive' | 'pending' | 'paused'
      - `support_email` string
      - `uid` string
      - `updated_at` string
      - `url` string
    - `event_id` string
    - `event_metadata` DatastoreEvent
      - `acknowledged_at` string
      - `app_id` string — Deprecated
      - `created_at` string
      - `data` integer[] — Data is an arbitrary JSON value that gets sent as the body of the webhook to the endpoints
      - `deleted_at` string
      - `endpoint_metadata` DatastoreEndpoint[]
        - `advanced_signatures` boolean
        - `authentication` DatastoreEndpointAuthentication
          - `api_key` DatastoreApiKey
            - `header_name` string
            - `header_value` string
          - `type` 'api_key'
        - `created_at` string
        - `deleted_at` string
        - `description` string
        - `events` integer
        - `failure_rate` number
        - `http_timeout` integer
        - `name` string
        - `owner_id` string
        - `project_id` string
        - `rate_limit` integer
        - `rate_limit_duration` integer
        - `secrets` DatastoreSecret[]
          - `created_at` string
          - `deleted_at` string
          - `expires_at` string
          - `uid` string
          - `updated_at` string
          - `value` string
        - `slack_webhook_url` string
        - `status` 'active' | 'inactive' | 'pending' | 'paused'
        - `support_email` string
        - `uid` string
        - `updated_at` string
        - `url` string
      - `endpoints` string[]
      - `event_type` string
      - `headers` HttpheaderHTTPHeader
      - `idempotency_key` string
      - `is_duplicate_event` boolean
      - `metadata` string
      - `project_id` string
      - `raw` string
      - `source_id` string
      - `source_metadata` DatastoreSource
        - `body_function` string
        - `created_at` string
        - `custom_response` DatastoreCustomResponse
          - `body` string
          - `content_type` string
        - `deleted_at` string
        - `forward_headers` string[]
        - `header_function` string
        - `idempotency_keys` string[]
        - `is_disabled` boolean
        - `mask_id` string
        - `name` string
        - `project_id` string
        - `provider` 'github' | 'twitter' | 'shopify'
        - `provider_config` DatastoreProviderConfig
          - `twitter` DatastoreTwitterProviderConfig
            - `crc_verified_at` string
        - `pub_sub` DatastorePubSubConfig
          - `amqp` DatastoreAmqpPubSubConfig
            - `auth` DatastoreAmqpCredentials
              - …
            - `bindedExchange` string
            - `deadLetterExchange` string
            - `host` string
            - `port` string
            - `queue` string
            - `routingKey` string
            - `schema` string
            - `vhost` string
          - `google` DatastoreGooglePubSubConfig
            - `project_id` string
            - `service_account` integer[]
            - `subscription_id` string
          - `kafka` DatastoreKafkaPubSubConfig
            - `auth` DatastoreKafkaAuth
              - …
            - `brokers` string[]
            - `consumer_group_id` string
            - `topic_name` string
          - `sqs` DatastoreSQSPubSubConfig
            - `access_key_id` string
            - `default_region` string
            - `queue_name` string
            - `secret_key` string
          - `type` 'sqs' | 'google' | 'kafka' | 'amqp'
          - `workers` integer
        - `type` 'http' | 'rest_api' | 'pub_sub' | 'db_change_stream'
        - `uid` string
        - `updated_at` string
        - `url` string
        - `verifier` DatastoreVerifierConfig
          - `api_key` DatastoreApiKey
            - `header_name` string
            - `header_value` string
          - `basic_auth` DatastoreBasicAuth
            - `password` string
            - `username` string
          - `hmac` DatastoreHMac
            - `encoding` 'base64' | 'hex'
            - `hash` string
            - `header` string
            - `secret` string
          - `type` 'noop' | 'hmac' | 'basic_auth' | 'api_key'
      - `status` 'Processing' | 'Failure' | 'Success' | 'Retry' | 'Pending'
      - `uid` string
      - `updated_at` string
      - `url_query_params` string
    - `event_type` string
    - `headers` HttpheaderHTTPHeader
    - `idempotency_key` string
    - `latency` string — Deprecated: Latency is deprecated.
    - `latency_seconds` number
    - `metadata` DatastoreMetadata
      - `data` integer[] — Data to be sent to endpoint.
      - `interval_seconds` integer
      - `max_retry_seconds` integer
      - `next_send_time` string
      - `num_trials` integer — NumTrials: number of times we have tried to deliver this Event to an application
      - `raw` string
      - `retry_limit` integer
      - `strategy` 'linear' | 'exponential'
    - `project_id` string
    - `source_metadata` DatastoreSource
      - `body_function` string
      - `created_at` string
      - `custom_response` DatastoreCustomResponse
        - `body` string
        - `content_type` string
      - `deleted_at` string
      - `forward_headers` string[]
      - `header_function` string
      - `idempotency_keys` string[]
      - `is_disabled` boolean
      - `mask_id` string
      - `name` string
      - `project_id` string
      - `provider` 'github' | 'twitter' | 'shopify'
      - `provider_config` DatastoreProviderConfig
        - `twitter` DatastoreTwitterProviderConfig
          - `crc_verified_at` string
      - `pub_sub` DatastorePubSubConfig
        - `amqp` DatastoreAmqpPubSubConfig
          - `auth` DatastoreAmqpCredentials
            - `password` string
            - `user` string
          - `bindedExchange` string
          - `deadLetterExchange` string
          - `host` string
          - `port` string
          - `queue` string
          - `routingKey` string
          - `schema` string
          - `vhost` string
        - `google` DatastoreGooglePubSubConfig
          - `project_id` string
          - `service_account` integer[]
          - `subscription_id` string
        - `kafka` DatastoreKafkaPubSubConfig
          - `auth` DatastoreKafkaAuth
            - `hash` string
            - `password` string
            - `tls` boolean
            - `type` string
            - `username` string
          - `brokers` string[]
          - `consumer_group_id` string
          - `topic_name` string
        - `sqs` DatastoreSQSPubSubConfig
          - `access_key_id` string
          - `default_region` string
          - `queue_name` string
          - `secret_key` string
        - `type` 'sqs' | 'google' | 'kafka' | 'amqp'
        - `workers` integer
      - `type` 'http' | 'rest_api' | 'pub_sub' | 'db_change_stream'
      - `uid` string
      - `updated_at` string
      - `url` string
      - `verifier` DatastoreVerifierConfig
        - `api_key` DatastoreApiKey
          - `header_name` string
          - `header_value` string
        - `basic_auth` DatastoreBasicAuth
          - `password` string
          - `username` string
        - `hmac` DatastoreHMac
          - `encoding` 'base64' | 'hex'
          - `hash` string
          - `header` string
          - `secret` string
        - `type` 'noop' | 'hmac' | 'basic_auth' | 'api_key'
    - `status` 'Scheduled' | 'Processing' | 'Discarded' | 'Failure' | 'Success' | 'Retry'
    - `subscription_id` string
    - `uid` string
    - `updated_at` string
    - `url_query_params` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

## Changes

- **2024-03-26** `2ddfad646792` — 1 info
  - api operation id `GetEventDelivery` was added
- **2024-01-30** `5a219dba9f40` — 1 info
  - api operation id `GetEventDelivery` removed and replaced with ``

[Change history](https://skmtc.dev/frain-dev/apis/convoy-api-reference/changes/v1/projects/:projectID/eventdeliveries/:eventDeliveryID/get.md)

---

[API](https://skmtc.dev/frain-dev/apis/convoy-api-reference.md) · [All operations](https://skmtc.dev/frain-dev/apis/convoy-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/frain-dev/apis/convoy-api-reference/revisions/b96e9d6385db?raw)
