## Retrieve Subscription Quantity History

`v1.contracts.retrieve_subscription_quantity_history(ContractRetrieveSubscriptionQuantityHistoryParams**kwargs)  -> ContractRetrieveSubscriptionQuantityHistoryResponse`

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

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

### Parameters

- **contract\_id:** `str`

- **customer\_id:** `str`

- **subscription\_id:** `str`

### Returns

- `class ContractRetrieveSubscriptionQuantityHistoryResponse`

  - **data:** `Data`

    - **fiat\_credit\_type\_id:** `Optional[str]`

    - **history:** `Optional[List[DataHistory]]`

      - **data:** `List[DataHistoryData]`

        - **quantity:** `float`

        - **total:** `float`

        - **unit\_price:** `float`

      - **starting\_at:** `datetime`

    - **subscription\_id:** `Optional[str]`

### Example

```python
from metronome import Metronome

client = Metronome(
    bearer_token="My Bearer Token",
)
response = client.v1.contracts.retrieve_subscription_quantity_history(
    contract_id="d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
    customer_id="13117714-3f05-48e5-a6e9-a66093f13b4d",
    subscription_id="1a824d53-bde6-4d82-96d7-6347ff227d5c",
)
print(response.data)
```