# Retrieve billing or turnover history
source: https://developer.mastercard.com/mastercard-processing-credit/documentation/use-cases/credit-card/retrieve-billing-turnover-history/index.md

## Overview {#overview}

The use case describes the process for a cardholder to display credit card history containing information, such as billing date, due date, due amount, or overdue amount for each or selected billing cycle. When a card is in use, it is essential to have proper monitoring tools for you and your cardholder. A credit card is driven by month-length billing cycles, which end with the billing date. The Mastercard Processing Credit API allows you to retrieve information on all or selected billing cycles, including balances and due amounts.

A credit card turnover gives basic and summarized info about card use in the past or current billing cycles. Credit card interests accrued on different account types, like retail or cash in different phases of aging, such as current or overdue, might be also retrieved.

## Sequence diagram {#sequence-diagram}

Diagram retrieve-billing-turnover-history

### Explanation {#explanation}

1. The cardholder decides to display their credit card billing details.
2. The mobile application or e-banking service sends the request to retrieve credit card billing details.

* `/contracts/{contract_id}/billing-histories` endpoint to retrieve billing history for a specified contract or
* `/contracts/{contract_id}/turnover-histories` endpoint to retrieve turnover history for a specified contract Note: For the standard credit product, the server must put the `accountContractId` value in place of `contract_id` in the path.

3. The API returns the requested data. Refer to [Endpoints](https://developer.mastercard.com/mastercard-processing-credit/documentation/use-cases/credit-card/retrieve-billing-turnover-history/index.md#endpoints) to check the complete list of data returned by the endpoints.
4. The server sends the data to the mobile application.
5. The mobile application displays credit card billing history details to the cardholder.  

Refer to [Sandbox testing](https://developer.mastercard.com/mastercard-processing-credit/documentation/sandbox-testing/index.md) for information on how to execute the use case in the Sandbox environment.

## Endpoints {#endpoints}


API Reference: `GET /contracts/{contract_id}/billing-histories`


API Reference: `GET /contracts/{contract_id}/turnover-histories`