List deliveries for a webhook subscription

GET/v1/api/store/{team_slug}/setting/webhook_subscription/{id}/log

v1Operation ID v1_public_webhook_subscription_log

Returns the subscription's deliveries, newest first, one page at a time. Each delivery is one event sent to this subscription, with the latest attempt's status code and error, when YoPrint retries next, and the event exactly as it was sent (message).

Use it to debug your endpoint: status_code is what your endpoint answered (999 when it didn't answer or YoPrint didn't send), and error says what went wrong in a sentence of YoPrint's, such as "The receiver answered with HTTP 500." YoPrint doesn't keep your endpoint's reply, so log it on your side.

Permission

Any team member can call it. Reading needs no extra permission.

Path parameters

• team_slugstringrequired

  Your team slug, shown as Team ID next to your API key in Profile.

  • Example your-team
• idstringrequired

  The webhook subscription's id: a hash id from an earlier answer. Only hash ids work here; anything else answers 404 page_not_found.

  • Example V4keXwwxMQyXw7

Query parameters

• pageinteger

  The page to return. A page holds the team's page size (50 unless the team changed it). per_page is not read.

  • Default 1
  • Minimum 1
  • Example 1

Request body

This operation takes no request body.

Response

200Successful response.

• dataarray of objectsrequired
  Fields of each item (13)

  • attemptintegerrequired

    Attempts made so far: 0 before the first, at most 3.

  • created_atstring (date-time)required

    When the delivery was queued.

  • errorstring | nullrequired

    Why the delivery failed. Null after a successful attempt (status: success). YoPrint never stores your endpoint's response body. For a failed attempt, this is one of:

    • The receiver answered with HTTP {status}. (your endpoint returned an HTTP status other than 200)
    • Could not reach the receiver (connection, DNS, TLS or timeout error).
    • Delivery failed before the receiver answered.
    • Not sent: the webhook URL does not reach a public internet address.
    • Not sent: this server cannot hold the connection to the checked receiver address.
  • idstringrequired

    The delivery id: one event to one subscription.

  • messageobjectrequired
    Child fields (5)

    • created_atstring (date-time)required

      When the event happened.

    • idstringrequired

      The event id. Every attempt to deliver this event, to every subscription, carries the same id.

    • payloadobjectrequired

      The record the event is about, as it was when the event happened. Its fields depend on the event; see "Events" on Create a webhook subscription.

    • typestringrequired

      The event name.

    • updated_atstring (date-time)required
  • next_retry_atstring (date-time) | nullrequired

    When YoPrint tries again, or null when it will not (after a success, or after the last attempt).

  • sent_atstring (date-time)required

    When the latest attempt was made. Before the first attempt (status pending), when the delivery was queued. Never null.

  • statusstringrequired

    pending before the first attempt, success when the latest attempt got exactly 200, error for any other status code.

    • One of: "pending", "success", "error"
  • status_codeinteger | nullrequired

    The HTTP status your endpoint returned on the latest attempt (such as 200 or 500). Set to 999 when no response was received (for example, connection timeouts, DNS lookup failures, TLS errors, or if the request was blocked before sending). Null before the first attempt.

  • updated_atstring (date-time)required
  • urlstring | nullrequired

    The destination URL for the latest delivery attempt: the full URL on this API. AI apps reading deliveries through YoPrint's MCP server see only the origin (scheme and host, such as https://example.com).

  • webhook_message_idstringrequired

    The event id, the same as id in the body YoPrint sent.

  • webhook_subscription_idstringrequired
• statusintegerrequired
• successbooleanrequired
• paginationobject
  Child fields (6)

  • countintegerrequired
  • currentPageintegerrequired
  • linksobject | array of anyrequired

    Links to the neighbouring pages: previous and next, each present only when that page exists. An empty list, [], when there is only one page.

    Child fields (2)

    • nextstring (uri)

      The next page.

    • previousstring (uri)

      The previous page.

  • perPageintegerrequired
  • totalintegerrequired
  • totalPagesintegerrequired

Errors

• 401The API key is missing or wrong (unauthenticated).

  When

  The API key is missing or wrong.

  Fix

  Send your personal API key as Authorization: Bearer YOUR_API_KEY.

• 403You are not allowed to do this. api_access_not_in_plan: your team's plan doesn't include API access (Pro and above, with an active subscription or trial), so every request answers this until the team upgrades. When your role lacks the permission the operation needs, the body is only {"message": "Insufficient Permission"}. Other refusals use the error envelope, with unauthorized or user_is_not_authorized.

• 404Not found. page_not_found: the team slug is unknown, you are not a member of the team, or an id in the path is not one of this team's. code: null, with a message that starts "No query results for": there is no record with that id.

  When

  No webhook subscription with that id on this team (error.code is null and error.message starts "No query results"), the id is not one of this team's hash ids, or you are not a member of the team (both page_not_found).

  Fix

  Use an id from the list operation and check the team slug.

Notes

• A delivery shows only its latest attempt. attempt counts them.
• status is success only for exactly 200. Any other 2xx shows as error, even though YoPrint stopped retrying.
• The path parameter is the subscription id.

Related

• GETShow a webhook subscription/v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}
• PATCHTouch a webhook subscription/v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}

Example request

curl

curl 'https://secure.yoprint.com/v1/api/store/your-team/setting/webhook_subscription/V4keXwwxMQyXw7/log' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -H 'Accept: application/json' \  -H 'X-Yoprint-Decimal-Format: exact-v1'

Example response 200

Response

{
  "data": [
    {
      "attempt": 1,
      "created_at": "2026-11-03T15:00:00+00:00",
      "error": null,
      "id": "gxL14iJJPyg63n",
      "message": {
        "created_at": "2026-11-03T15:00:00+00:00",
        "id": "VwYKuTP9vd8Dfo",
        "payload": {
          "calc_total": 125000,
          "formatted_calc_total": "$125.00",
          "id": "BkzhmfgkK2HFTs",
          "name": "Team shirts",
          "scoped_id": "SO1001",
          "status_id": "PLksRyu0AR7Bv4",
          "unique_key": "ord_EXAMPLEuniqueKey"
        },
        "type": "order.created",
        "updated_at": "2026-11-03T15:00:00+00:00"
      },
      "next_retry_at": null,
      "sent_at": "2026-11-03T15:00:00+00:00",
      "status": "success",
      "status_code": 200,
      "updated_at": "2026-11-03T15:00:00+00:00",
      "url": "https://example.com/yoprint/webhooks",
      "webhook_message_id": "VwYKuTP9vd8Dfo",
      "webhook_subscription_id": "V4keXwwxMQyXw7"
    }
  ],
  "pagination": {
    "count": 1,
    "currentPage": 1,
    "links": [],
    "perPage": 50,
    "total": 1,
    "totalPages": 1
  },
  "status": 200,
  "success": true
}