List recent deliveries

GET

/organization_webhooks/{extId}/deliveries

curl --request GET \
  --url https://api.retorio.com/be/v2/organization_webhooks/9d4e2b71_3c8a_4f05_b6e2_1a7c5d9e0f38/deliveries \
  --header 'Authorization: Bearer <token>'

The webhook’s most recent deliveries (up to 50), newest first, across every configuration version it has ever had. One row per event, summarizing its attempts (attemptCount, lastStatusCode, lastError), useful for diagnosing a receiver that is failing or has gone quiet. lastError holds at most 500 characters. On a cancelled row, and on a failed row Retorio settled without recording a send (a delivery Retorio stopped retrying for its own reasons, a stored event that no longer validates, a test whose outcome could not be recorded), it holds Retorio’s reason, which replaces the last error text, while lastStatusCode keeps the code of the last recorded attempt. updatedAt is the creation time and does not track status changes: read status and deliveredAt instead.

Authentication

Auth

Access key

Roles

Owner / Custom

Parameters

Path Parameters

extId

required

string

Example

9d4e2b71_3c8a_4f05_b6e2_1a7c5d9e0f38

Responses

200

OK

Media typeapplication/json

object

deliveries

required

Array<object>

object

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

extId

required

string

<= 64 characters

eventType

required

string

<= 64 characters

status

required

string

Allowed values: pending succeeded failed cancelled

attemptCount

required

integer

lastStatusCode

required

integer

nullable

lastError

required

string

nullable

deliveredAt

required

string format: date-time

nullable

Example

{
  "deliveries": [
    {
      "status": "pending"
    }
  ]
}

401

Not authenticated: the bearer token is missing, malformed, expired or revoked, its sign-in method does not match your organization’s configuration, the user it belongs to was removed, or your organization is deactivated.

Media typeapplication/json

object

message

required

string

status

required

Canonical error name, e.g. INVALID_ARGUMENT.

string

details

nullable

Example ^generated

{
  "message": "example",
  "status": "example",
  "details": "example"
}

403

Refused: the token does not belong to an admin, or the admin’s roles do not grant webhooks:manage.

Media typeapplication/json

Any of:

object

object

message

required

string

status

required

Canonical error name, e.g. INVALID_ARGUMENT.

string

details

nullable

object

object

statusCode

required

integer

message

required

string

error

required

The HTTP reason phrase, e.g. Bad Request.

string

Example ^generated

{
  "message": "example",
  "status": "example",
  "details": "example"
}

404

No webhook with this extId in your organization.

Media typeapplication/json

object

message

required

string

status

required

Canonical error name, e.g. INVALID_ARGUMENT.

string

details

nullable

Example ^generated

{
  "message": "example",
  "status": "example",
  "details": "example"
}

500

Internal Server Error

Media typeapplication/json

object

key

additional properties

nullable

Example ^generated

{
  "additionalProperty": "example"
}