# Get a subscription

`GET https://api.cryptohopper.com/v1/subscription/{subscription_id}`

Part of [Subscriptions](https://www.cryptohopper.com/api-documentation/api-reference/subscriptions.md) in the Cryptohopper API reference.

Returns one of the user's subscriptions, with the name and description of its plan. A subscription that has ended returns 404.

OAuth scope: `read`

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `subscription_id` | string | yes | ID of the subscription. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/subscription/SUBSCRIPTION_ID" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "subscription_id": "466000",
        "plan_id": "2",
        "payment_term": "month",
        "payment_method_id": "2",
        "start_time": "2026-09-01 10:15:00",
        "end_time": "2026-10-01 10:15:00",
        "subscription_status": "Active",
        "plan_name": "Adventurer",
        "plan_description": "For traders who want more positions and faster checks.",
        "exchange_only": "all",
        "auto_renewal": "Yes"
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.