# Get subscription

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

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

Returns the subscription linked to the hopper with its plan, term, dates and renewal status.

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 |
|---|---|---|---|
| `id` | string | yes | Hopper ID. |

## Example request

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

## Response

Example response (illustrative values):

```json
{
    "data": {
        "subscription": {
            "hopper_id": 123456,
            "subscription_id": "456789",
            "plan_id": "2",
            "payment_term": "month",
            "payment_method_id": "1",
            "start_time": "2026-09-01 10:00:00",
            "end_time": "2026-10-01 10:00:00",
            "subscription_status": "Active",
            "auto_renewal": "Yes",
            "plan_name": "Adventure",
            "plan_description": "Adventure plan"
        }
    }
}
```

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.