# Fetch Subscription by Token

Retrieve the details of a specific subscription using its token. 

**Notes:**
  * Requires a valid API Key with access to the profile.
  * The token must match a subscription created under your profile.

**Method:** `GET`

**Path:** ```
https://api.blockbee.io/subscription/fetch/
```

## Parameters

### Query Parameters

- **`apikey`** (`string`) (required): API Key provided by BlockBee's [Dashboard](https://dash.blockbee.io/). Unsure how to get yours? [Check this tutorial](https://support.blockbee.io/support/solutions/articles/204000013926-how-to-generate-a-new-api-key).

**Note:** The API key can also be sent as a header named `apikey`.

- **`token`** (`string`) (required) - Example: `I55hhRINHptLJPwsqwYNxJOKBItRiq1o`: Unique subscription token.

---

## Returns

Returns the details of the specified subscription.

- **`status`** (`string`): Status of the request.

- **`subscription`** (`object`): Contains detailed information about the subscription.

  - **`token`** (`string`): Token associated with the subscription.

  - **`url`** (`string`): Subscription or payment link for the customer.

  - **`active`** (`boolean`): Indicates if the subscription is active.

  - **`user_id`** (`string`): User identifier in your system.

  - **`user_email`** (`string`): Customer e-mail.

  - **`end_date_ts`** (`integer`): Timestamp of the subscription's expiration (may be null).

  - **`payment_list`** (`object[]`): List of completed payments for the subscription.

  - **`token`** (`string`): Token for the specific payment.

  - **`value`** (`string`): The value of the payment.

  - **`coin`** (`string`): The cryptocurrency used for the payment.

  - **`duration_ts`** (`integer`): Duration in seconds.

  - **`received_fiat`** (`string`): FIAT amount received for the payment.

  - **`is_paid`** (`boolean`): `true` if the payment is paid.

  - **`is_pending`** (`boolean`): `true` if the payment is pending blockchain confirmation.

  - **`is_partial`** (`boolean`): `true` if the payment is partially paid.



## Example Response

```json
{
  "status": "success",
  "subscription": {
    "token": "J78yEgW01HIOGZqBeqzxpXFuCwHGQgdO",
    "url": "https://pay.blockbee.io/subscription/J78yEgW01HIOGZqBeqzxpXFuCwHGQgdO/",
    "active": true,
    "user_id": "user_example",
    "user_email": "example@mail.com",
    "end_date_ts": 1753022709,
    "payment_list": [
      {
        "token": "Wd1lggEvyy1usHooflFiEGNQbBn4TNvJ",
        "value": "1.99",
        "coin": "usd",
        "duration_ts": 2592000,
        "received_fiat": "1.99",
        "is_paid": true,
        "is_pending": false,
        "is_partial": false
      }
    ]
  }
}
```