# List Subscriptions

> List Subscriptions is a paid API for AI agents from inbox.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-16, last successful call 2026-07-29).

Returns all active topic subscriptions associated with the caller's inbox wallet.

## Facts

- Endpoint: GET https://inbox.withzero.xyz/api/v1/subscriptions
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-16
- Last successful call: 2026-07-29
- Success rate: 100% of calls made through Zero
- Activations on Zero: 3
- Provider: inbox.withzero.xyz
- Website: https://inbox.withzero.xyz
- Canonical page: https://www.zero.xyz/c/inbox-withzero-xyz-list-your-subscriptions-d12faa86
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WmxXdoDOOZvOtN_fhPslp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability inbox-withzero-xyz-list-your-subscriptions-d12faa86
```

Example prompt: Show me all the topic subscriptions on my inbox.withzero.xyz inbox — I want to see which topic patterns I'm subscribed to and what triggers are configured for each one.

## When to prefer this

Use this endpoint when an agent needs to audit its current subscriptions, verify a subscription was created, check trigger configurations (webhook vs scheduler), or clean up stale subscriptions before creating new ones. Prefer over guessing subscription state.

## Known failure modes

- 401 Unauthorized — missing or invalid signed proof credential
- 403 Forbidden — proof credential does not match a provisioned inbox
- 404 Not Found — inbox has expired or was never provisioned (call POST /api/v1/inboxes first)
- 500 Internal Server Error — backend unavailable
- Empty array returned — no subscriptions have been created yet

## How this service works

List your subscriptions. 📖 Full guide: https://inbox.withzero.xyz/llms.txt

## Output

Returns a JSON object with a 'subscriptions' array; each element contains: id (string), fromWallet (wallet address), topicPattern (glob pattern for subscribed topic), trigger (either null, a scheduler-run object with taskId UUID, or a webhook object with url and optional secret), and createdAt timestamp.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "subscriptions"
 ],
 "properties": {
  "subscriptions": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "fromWallet",
     "topicPattern",
     "trigger",
     "createdAt"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "trigger": {
      "anyOf": [
       {
        "oneOf": [
         {
          "type": "object",
          "required": [
           "type",
           "taskId"
          ],
          "properties": {
           "type": {
            "type": "string",
            "const": "scheduler-run"
           },
           "taskId": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
           }
          },
          "additionalProperties": false
         },
         {
          "type": "object",
          "required": [
           "type",
           "url"
          ],
          "properties": {
           "url": {
            "type": "string",
            "format": "uri"
           },
           "type": {
            "type": "string",
            "const": "webhook"
           },
           "secret": {
            "type": "string",
            "maxLength": 256,
            "minLength": 8
           }
          },
          "additionalProperties": false
         }
        ]
       },
       {
        "type": "null"
       }
      ]
     },
     "createdAt": {
      "type": "string"
     },
     "fromWallet": {
      "type": "string"
     },
     "topicPattern": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/inbox-withzero-xyz-list-your-subscriptions-d12faa86/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from inbox.withzero.xyz](https://www.zero.xyz/host/inbox.withzero.xyz/llms.txt)