API Reference

Webhooks

Deliveries

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get a delivery

GET/v2/webhooks/{teamId}/{webhookId}/deliveries/{deliveryId}

A single delivery plus its full attempt timeline (including async retries).

Path ParametersExpand Collapse

teamId: optional string

formatuuid

webhookId: string

formatuuid

deliveryId: string

formatuuid

ReturnsExpand Collapse

WebhookDeliveryDetail = WebhookDelivery { created_at, delivery_id, status, 8 more }

A delivery plus its full attempt timeline.

attempt_history: optional array of object { attempt, created_at, status, 4 more }

attempt: number

1-based attempt number.

created_at: string

formatdate-time

status: "success" or "failed"

One of the following:

"success"

"failed"

error: optional string

Failure reason, when status is failed.

request_body: optional string

Body sent to the endpoint (delivery only); may be truncated.

response_body: optional string

Body returned by the endpoint; may be truncated.

status_code: optional number

Get a delivery

HTTP

HTTP

TypeScript

Python

Go

CLI Tool

curl https://developers.micro.so/v2/webhooks/$TEAM_ID/$WEBHOOK_ID/deliveries/$DELIVERY_ID \
    -H "x-api-key: $MICRO_API_KEY"

200 example

{
  "created_at": "2019-12-27T18:11:19.117Z",
  "delivery_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "status": "success",
  "type": "delivery",
  "webhook_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "attempts": 0,
  "event": "event",
  "status_code": 0,
  "team_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "url": "url",
  "attempt_history": [
    {
      "attempt": 0,
      "created_at": "2019-12-27T18:11:19.117Z",
      "status": "success",
      "error": "error",
      "request_body": "request_body",
      "response_body": "response_body",
      "status_code": 0
    }
  ]
}

Returns Examples

200 example

{
  "created_at": "2019-12-27T18:11:19.117Z",
  "delivery_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "status": "success",
  "type": "delivery",
  "webhook_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "attempts": 0,
  "event": "event",
  "status_code": 0,
  "team_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "url": "url",
  "attempt_history": [
    {
      "attempt": 0,
      "created_at": "2019-12-27T18:11:19.117Z",
      "status": "success",
      "error": "error",
      "request_body": "request_body",
      "response_body": "response_body",
      "status_code": 0
    }
  ]
}