Subscriptions and waits

List subscriptions

GET/v1/agent/subscriptions

Returns agent subscriptions.

Parameters

Query parameters2

status?string

active, done, expired or cancelled.

label?string

Your own task label.

Returns

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

GETList subscriptions

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

const res = await fetch("https://api.getensue.com/v1/agent/subscriptions", {
  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/agent/subscriptions",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

{
  "items": [
    {
      "id": "sub_9c4t…",
      "status": "active",
      "label": "t_42",
      "source": {
        "id": "src_8f2k…",
        "name": "stripe-prod"
      },
      "destination": {
        "id": "dst_7q1c…",
        "name": "billing-agent",
        "type": "inbox"
      },
      "correlation": "t_42",
      "max_events": 1,
      "matched": 0,
      "expires_at": "2026-11-11T10:00:00.000Z",
      "kind": "subscription"
    }
  ]
}

{"items":[{"id":"sub_9c4t…","status":"active","label":"t_42","source":{"id":"src_8f2k…","name":"stripe-prod"},"destination":{"id":"dst_7q1c…","name":"billing-agent","type":"inbox"},"correlation":"t_42","max_events":1,"matched":0,"expires_at":"2026-11-11T10:00:00.000Z","kind":"subscription"}]}