Destinations

List destinations

GET/v1/destinations

Returns push destinations and inboxes with their health and pending counts.

Parameters

This endpoint takes no parameters.

Returns

200The sample response is on the right.Errors return error and message; see Errors and limits.

GETList destinations

curl "https://api.getensue.com/v1/destinations" \
  -H "authorization: Bearer $ENSUE_API_KEY"

const res = await fetch("https://api.getensue.com/v1/destinations", {
  method: "GET",
  headers: {
    authorization: `Bearer ${process.env.ENSUE_API_KEY}`,
  },
});
console.log(await res.json());

import os, requests

res = requests.get(
    "https://api.getensue.com/v1/destinations",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

{
  "items": [
    {
      "id": "dst_3m9x…",
      "name": "billing-api",
      "type": "http",
      "url": "https://api.example.com/webhooks/ensue",
      "status": "active",
      "created": 1762761600000,
      "auth_type": "none",
      "signing_secret": "whsec_…",
      "timeout_ms": 15000,
      "max_attempts": 8,
      "format": "raw",
      "max_in_flight": 10,
      "breaker": {
        "state": "closed"
      }
    }
  ]
}

{"items":[{"id":"dst_3m9x…","name":"billing-api","type":"http","url":"https://api.example.com/webhooks/ensue","status":"active","created":1762761600000,"auth_type":"none","signing_secret":"whsec_…","timeout_ms":15000,"max_attempts":8,"format":"raw","max_in_flight":10,"breaker":{"state":"closed"}}]}