Get delivery task status and logs

GET /deliveries/{delivery_task_id}

Retrieve the status and all delivery attempts/logs for a delivery task.

Path parameters

  • delivery_task_id string Required

    Delivery task ID

Responses

  • 200 application/json

    Delivery task status and logs

    Hide response attributes Show response attributes object
    • task object
      Hide task attributes Show task attributes object
      • id string(uuid)
      • subscription_id string(uuid)
      • payload string

        The JSON payload of the webhook event.

      • status string

        Current status of the delivery task.

        Values are pending, processing, delivered, or failed.

      • created_at string(date-time)
      • last_attempt_at string(date-time) | null
      • attempt_count integer
    • logs array[object]
      Hide logs attributes Show logs attributes object
      • id string(uuid)
      • delivery_task_id string(uuid)
      • subscription_id string(uuid)
      • target_url string
      • timestamp string(date-time)
      • attempt_number integer
      • outcome string

        Outcome of the delivery attempt.

        Values are success or failed_attempt.

      • http_status integer | null
      • error_details string | null
  • 404 application/json

    The requested resource was not found.

    Hide response attribute Show response attribute object
    • error string
  • 500 application/json

    An unexpected error occurred on the server.

    Hide response attribute Show response attribute object
    • error string
GET /deliveries/{delivery_task_id}
curl \
 --request GET 'http://localhost:8080/deliveries/{delivery_task_id}'
Response examples (200)
{
  "task": {
    "id": "task-uuid",
    "status": "pending",
    "payload": "{\"event\":\"order.created\"}",
    "created_at": "2025-05-12T12:00:00Z",
    "attempt_count": 2,
    "last_attempt_at": "2025-05-12T12:01:00Z",
    "subscription_id": "sub-uuid"
  },
  "logs": [
    {
      "id": "log-uuid",
      "outcome": "failed_attempt",
      "timestamp": "2025-05-12T12:01:00Z",
      "target_url": "https://webhook.site/your-url",
      "http_status": 500,
      "error_details": "Timeout",
      "attempt_number": 2,
      "subscription_id": "sub-uuid",
      "delivery_task_id": "task-uuid"
    }
  ]
}
Response examples (404)
{
  "error": "string"
}
Response examples (500)
{
  "error": "string"
}