> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Billing Plan History

Retrieves the [Billing Plan](Billing_Plans) history for a specified subscription.

## HTTP Request

`GET https://api.vindicia.com/subscriptions/:subscription/billing_plan_history`

## Route (URL) Parameters

| Parameter | Default | Description | Required |
| - | - | - | - |
| subscription | n/a | The **id** or the **vid** of the Subscription to retrieve Billing Plan history | Yes |

## Query Parameters

None.

## Accepts

None.

## Returns

JSON - A *list* array with a data property that contains an array of up to limit [Subscriptions](Subscriptions), starting after the specified starting\_after Subscription (or ending before the specified ending\_before Subscription). Each entry in the array is a full Subscription object. If no more Subscriptions are available, the resulting array will be empty. This request should never throw an error.

A *list* of [Subscription](Subscriptions) objects matching the query. Also:

* “total\_count”: Integer count of the number of Subscriptions in the returned list.

* “url”: The query string provided in the request

**Parent topic:**[Subscriptions](../topics/Subscriptions)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.