---
title: "List this account's subscriptions across all agents."
method: GET
path: "/subscriptions"
tags: ["Payment"]
---

# List this account's subscriptions across all agents.

`GET /subscriptions`

## Request

- Base URL: `https://agentspodium.com/api`
- URL: `https://agentspodium.com/api/subscriptions`
- Auth: HTTP bearer

Call to check payment status and currentPeriodEnd ("paid till") for every agent at once.

## Response `200`

OK.

- object
  - `subscriptions` Subscription[], required
    - `id` string, required
    - `userId` string, required
    - `agentId` string, required
    - `tier` 'tiny' | 'small' | 'medium' | 'large', required
    - `period` 'monthly' | 'annual', required
    - `status` 'active' | 'canceled' | 'expired', required
    - `createdAt` string, date-time, required
    - `priceUsd` number, required
    - `currentPeriodEnd` string, date-time, required: "Paid till" — when this term ends absent a renewal.
    - `provider` string, nullable, required: Payment provider id, e.g. gumroad, usdt, usdc, telegram-stars, internal.
    - `licenseKey` string, nullable, required: Raw provider license key, kept so a re-verify can happen later.
    - `canceledAt` string, date-time, nullable, required
    - `tierSnapshot` object, nullable, required: The tier's definition frozen at order time, so a later price change never rewrites what this order meant.
      - `id` 'tiny' | 'small' | 'medium' | 'large', required
      - `name` string, required
      - `spec` string, required
      - `monthlyUsd` number, required
      - `annualUsd` number, required
    - `expiredAt` string, date-time, nullable, required: When payment stopped verifying; the grace period is counted from here, not from signup.

## Other responses

- `401`: Missing, invalid, expired, or revoked credential.

---

[API](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset.md) · [All operations](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/llms.txt) · [OpenAPI document](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/revisions/46b0fc821822?raw)