## Retrieve Subscription Quantity History

`client.v1.contracts.retrieveSubscriptionQuantityHistory(ContractRetrieveSubscriptionQuantityHistoryParamsbody, RequestOptionsoptions?): ContractRetrieveSubscriptionQuantityHistoryResponse`

**post** `/v1/contracts/getSubscriptionQuantityHistory`

Fetch the quantity and price for a subscription over time. End-point does not return future scheduled changes.

### Parameters

- **body:** `ContractRetrieveSubscriptionQuantityHistoryParams`

  - **contract\_id:** `string`

  - **customer\_id:** `string`

  - **subscription\_id:** `string`

### Returns

- `ContractRetrieveSubscriptionQuantityHistoryResponse`
  - **data:** `Data`

    - **fiat\_credit\_type\_id:** `string`

    - **history:** `Array<History>`

      - **data:** `Array<Data>`

        - **quantity:** `number`

        - **total:** `number`

        - **unit\_price:** `number`

      - **starting\_at:** `string`

    - **subscription\_id:** `string`

### Example

```node
import Metronome from '@metronome/sdk';

const client = new Metronome({
  bearerToken: 'My Bearer Token',
});

const response = await client.v1.contracts.retrieveSubscriptionQuantityHistory({
  contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
  customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
  subscription_id: '1a824d53-bde6-4d82-96d7-6347ff227d5c',
});

console.log(response.data);
```