# Get subscriptions

`GET https://api.cryptohopper.com/v1/subscription`

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

Returns the user's subscriptions that have not ended yet, newest first.

OAuth scope: `read`

In this list plan_name holds the account holder's name instead of the plan name, and plan_description is missing. Get a subscription returns the plan name and description. exchange_only is all, or the only exchange the subscription can be used on.

## Headers

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

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `unassigned` | string | no | Filter on bot assignment: 1 returns only subscriptions that are not assigned to a bot, 0 only subscriptions that are. Leave it out for all. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/subscription" \
  -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": "Jane Doe",
            "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.