# View Historical Transaction Footprints
source: https://developer.mastercard.com/carbon-calculator/documentation/use-cases/historical_txn_footprint/index.md

The **View Historical Transaction Footprints** service allows the issuer to fetch the transaction footprints for their registered consumers' PAN based on the past payment transactions.

The issuer can use this response data directly and show it to the respective consumers. Also, the issuer can aggregate the response data based on the category information to add more insights for their consumers.

### Sample Screenshots {#sample-screenshots}

The following screenshots show the sample screens that can be rendered using this service:
![Historical_carbon](https://static.developer.mastercard.com/content/carbon-calculator/Images/usecases/Historical.png)

## Pre-requisites {#pre-requisites}

Following are the pre-requisites for the issuer to use this service:

1. A PAN should be registered.
2. The issuer should have `payment_card_id` stored for the requesting consumer.

Note:   

* For a recently registered PAN, the historical transaction footprints will be available after **24-36 hours of registration** . There are schedulers available to fetch historical transactions which are configurable to run at some pre-defined intervals. **Although these intervals are subject to change, they usually run within 24 hours**.
* In the Historical transaction footprint, each transaction will have the Transaction Indicator as below. This might help to build the user experience.
  * **CL** - Cleared Transaction
  * **RFT** - Refund Transaction
Tip: To create your project on Mastercard Developers, refer to the [Before You Start](https://developer.mastercard.com/carbon-calculator/documentation/index.md#before-you-start) section for more information.

## Sequence Diagram {#sequence-diagram}

The following sequence diagram shows the order of events for a solution that uses the `/payment-cards/{payment_card_id}/transaction-footprints` endpoint.

Diagram historical-carbon

**Following are the execution steps:**

1. Consumer requests to view the historical transaction footprints for the payment card.
2. The issuer app sends the request to the issuer server.
3. The issuer server sends the request to /payment-cards/{payment_card_id}/transaction-footprints service with the corresponding payment_card_id.
4. The Carbon Calculator application validates the request and the payment_card_id.
5. The Carbon Calculator application fetches the data as per request.
6. The Carbon Calculator application sends the historical transaction footprints to the issuer server.
7. The issuer server may prepare the additional insights and send them with the historical transaction footprints to the issuer app.
8. The issuer app displays the historical transaction footprints to the consumer.

<br />

You will receive an error response for an invalid request or any missing request parameter. Note:   

* For more information about the error codes, refer to [Code and Formats](https://developer.mastercard.com/carbon-calculator/documentation/code-and-formats/index.md).
* Authorized and cleared transactions can be matched using Bank net reference number and Bank net reference date with an accuracy of 95%. We may not always have a 1:1 mapping between the authorized and cleared transactions.

## Endpoint {#endpoint}


API Reference: `GET /payment-cards/{payment_card_id}/transaction-footprints`