Skip to content
Linra Omni Vendor Docs

List delivery attempts for a webhook subscription

GET
/api/v1/vendor/webhooks/{id}/deliveries
curl --request GET \
  --url 'https://api-omni.linra.net/api/v1/vendor/webhooks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/deliveries?page=1&pageSize=20' \
  --header 'Authorization: Bearer <token>'

Self-serve debugging read — every delivery ATTEMPT (not just distinct logical events) within the configured retention window, newest first. Requires the Orders capability.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
page
integer
default: 1 >= 1
pageSize
integer
default: 20 >= 1 <= 100

Responses

Section titled “Responses”

200

Section titled “200”

A page of delivery attempts.

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
items
Array<object>
object
id
string format: uuid
eventType
string
Allowed values: vendor.order.assigned vendor.offer.review-decision
idempotencyKey

Stable across every retry attempt of the SAME logical event — the same value that appears as eventId in the delivered envelope. Use it to dedupe.

string
attemptNumber
integer
httpStatus
integer
nullable
sentAt
string format: date-time
nullable
succeeded
boolean
errorSummary
string
nullable
deadLetteredAt
string format: date-time
nullable
nextAttemptAt
string format: date-time
pagination
object
page
integer
pageSize
integer
totalCount
integer
totalPages
integer
Example
{
  "state": "SUCCESS",
  "payload": {
    "items": [
      {
        "eventType": "vendor.order.assigned"
      }
    ]
  }
}

403

Section titled “403”

Your token doesn’t carry the capability this endpoint requires.

Media typeapplication/json
object
state
required
string
payload
details
object
Examples
ExamplemissingCapability
{
  "state": "FORBIDDEN_CAPABILITY_NOT_GRANTED",
  "payload": null,
  "details": {
    "requiredCapability": "Orders"
  }
}

404

Section titled “404”

Unknown subscription id.

Media typeapplication/json
object
state
required
string
payload
details
object
Examples
ExamplenotFound
{
  "state": "NOT_FOUND_VENDOR_WEBHOOK_SUBSCRIPTION",
  "payload": null,
  "details": {}
}

429

Section titled “429”

Too many requests. Retry after the Retry-After header (seconds).

Media typeapplication/json
object
state
required
string
payload
details
object
Example
{
  "state": "NOT_FOUND_VENDOR_OFFER"
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying.