## Retrieve Subscription Quantity History

`v1.contracts.retrieve_subscription_quantity_history(**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:** `String`

- **customer\_id:** `String`

- **subscription\_id:** `String`

### Returns

- `class ContractRetrieveSubscriptionQuantityHistoryResponse`

  - **data:** `{ fiat_credit_type_id, history, subscription_id}`

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

    - **history:** `Array[{ data, starting_at}]`

      - **data:** `Array[{ quantity, total, unit_price}]`

        - **quantity:** `Float`

        - **total:** `Float`

        - **unit\_price:** `Float`

      - **starting\_at:** `Time`

    - **subscription\_id:** `String`

### Example

```ruby
require "metronome_sdk"

metronome = MetronomeSDK::Client.new(bearer_token: "My Bearer Token")

response = metronome.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"
)

puts(response)
```