Subscriptions

Get a subscription

One subscription with its grants embedded.

payment_status is one of trialing, active, incomplete, expired, past_due, canceled, unpaid, paused, processing, succeeded, capturable or failed (the subscriby://enums/subscription-status MCP resource lists them).

compensation_seconds is the outage time Outage Compensation has banked on the purchase, 0 for almost every subscription. ends_at already includes it: a one-time purchase simply ends later, while a recurring plan's ends_at runs that many seconds past the period the member last paid for, so the renewal the gateway bills is ends_at minus compensation_seconds.

get/v1/subscriptions/{subscription}

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/subscriptions/{subscription}
  • Auth: HTTP bearer

Path parameters

subscriptionstring uuid required

The subscription, resolved by the route binder.

Response

The subscription, its access grants embedded.

Example response

{
  "data": {
    "id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
    "plan_id": "c4e82f16-93a7-4d5b-b81c-6e0f27a94d3b",
    "subscriber_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "method_id": "8b0c4a15-e792-4360-95d8-1f47c0b3e926",
    "payment_status": "active",
    "payment_price": "29.00",
    "currency_id": "8f27a0d4-63be-4915-8c07-1a5d9e34b628",
    "ends_at": "2026-06-18T10:05:00Z",
    "created_at": "2026-05-18T10:05:00Z",
    "updated_at": "2026-05-18T10:05:00Z",
    "grants": [
      {
        "id": "7d1c3e9a-2b64-4f0e-9a58-3c6b1d8e2f47",
        "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
        "resource_id": "c9e21f37-8a4b-4d56-b1e0-2f7c9d3a6e15",
        "identity_id": "0c2d8a7e-4b1f-4d3e-9a6b-2f5e8c1d7a90",
        "connector": "telegram",
        "mode": "bearer_link",
        "state": "granted",
        "reference": "https://t.me/+AbCdEfGhIjKlMnOp",
        "granted_at": "2026-09-12T10:05:00Z",
        "created_at": "2026-09-12T10:04:58Z"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.