Skip to content
BolderBolder Developers
Esc
↑↓navigate↵open⌘Jpreview

List webhooks for a seller

Seller-nested equivalent of GET /webhooks?seller_id=X.

GET/sellers/{seller_id}/webhooks
Authorization
AuthorizationBearer token (JWT) · headerrequired
Path parameters
seller_idintegerrequired
Responses
200

Webhooks list

total_itemsinteger
per_pageinteger
pageinteger
_linksHalLinks
_classstring[]
_embeddedobject
Show properties
subscriptionsWebhook[]
Show properties
Array of Webhook
_linksHalLinks
idinteger
channel_idinteger
topicstring

The topic, spelled the way this subscription receives it (see topic_style).

topic_stylestring

How the topic is spelled in the notifications this subscription receives. Subscriptions created through v2 are singular; those created before the singular spelling existed, or through v1, stay plural so their consumers are not affected.

Allowed:singularplural
urlstring
statusstring

active — receiving deliveries normally. failed_activation — the initial activation handshake failed. failed — disabled automatically after 100 consecutive non-2xx delivery responses (see error_count); can be re-enabled via PUT /webhooks/{id}/reactivate. disabled — the target URL returned 410 Gone; disabled immediately, with no retry threshold. Also reactivatable via the same endpoint.

Allowed:activefailed_activationfaileddisabled
authobject
notify_originboolean
app_idinteger
error_countinteger
last_errorstring
last_error_onstring<date-time>
created_onstring<date-time>
updated_onstring<date-time>
Try it
Server
Authorization
Parameters
Request
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/sellers/5/webhooks"
Response
{
  "total_items": 42,
  "per_page": 20,
  "page": 1,
  "_links": {
    "property1": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    },
    "property2": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    }
  },
  "_class": [
    "results",
    "hubSubscriptions"
  ],
  "_embedded": {
    "subscriptions": [
      {
        "_links": {
          "property1": {
            "href": "string",
            "templated": true,
            "method": "get",
            "title": "string",
            "type": "string"
          },
          "property2": {
            "href": "string",
            "templated": true,
            "method": "get",
            "title": "string",
            "type": "string"
          }
        },
        "id": 0,
        "channel_id": 0,
        "topic": "order.created",
        "topic_style": "singular",
        "url": "https://myapp.com/events",
        "status": "active",
        "auth": {},
        "notify_origin": true,
        "app_id": 0,
        "error_count": 0,
        "last_error": "string",
        "last_error_on": "2019-08-24T14:15:22Z",
        "created_on": "2019-08-24T14:15:22Z",
        "updated_on": "2019-08-24T14:15:22Z"
      }
    ]
  }
}

Was this page helpful?