# Fetch Historical Transaction Footprints
source: https://developer.mastercard.com/carbon-calculator/documentation/testing/testcase/test_case_fetch_historical_footprint/index.md

Allows a Service Provider to fetch historical transactions for a payment card. Note that maximum of one year of transactions can be retrieved using this API.

## Pre-requisites {#pre-requisites}

Refer to the [View Historical Transaction Footprints](https://developer.mastercard.com/carbon-calculator/documentation/use-cases/historical_txn_footprint/index.md) use case.


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

<br />

## Test Cases {#test-cases}

### Test Case: Success-Fetch Historical Transaction Footprints {#test-case-success-fetch-historical-transaction-footprints}

##### Response {#response}

```json
{
  "count": 2,
  "offset": 1,
  "limit": 2,
  "total": 5,
  "items": [
    {
      "transactionMetadata": {
        "id": "ee421c25-f928-4bf6-b884-3600b76b860d",
        "traceId": "9f52386ce297173ecfeb9120aabb0805bbeeb1350ce1de640864852e800bd206",
        "banknetReferenceNumber": "MPL0R6B2R",
        "banknetDate": "0525",
        "retrievalRefNumber": "MCC000100",
        "processingCode": "00",
        "dateAndTime": "2018-07-02T19:20+01:00",
        "merchantName": "ABC Store",
        "acquiringInstitutionCountryCode": "USA",
        "acquiringInstitutionCode": "12312312312",
        "amount": "25.50",
        "currencyCode": "USD",
        "indicator": "CL"
      },
      "transactionFootPrint": {
        "mcc": 3997,
        "carbonEmissionInGrams": 48.52,
        "carbonEmissionInOunces": 1.71,
        "category": {
          "mainCategory": "Lesure & Entertainment",
          "subCategory": "Hotels & Vacation",
          "sector": "Hotels, Motels & Resorts",
          "sectorCode": "604"
        },
        "scoreReference": "MCC"
      }
    },
    {
      "transactionMetadata": {
        "id": "fdc4626c-f51e-4ba6-9728-c79ac1d9aec8",
        "traceId": "af55386ce297173ecfeb9120aabb0805bbeeb1350ce1de640864852e800bd854",
        "banknetReferenceNumber": "MPL0R8C2A",
        "banknetDate": "0624",
        "retrievalRefNumber": "MCC000480",
        "processingCode": "01",
        "dateAndTime": "2019-12-25T19:20+01:00",
        "merchantName": "ABC Store",
        "acquiringInstitutionCountryCode": "USA",
        "acquiringInstitutionCode": "23423423423",
        "amount": "30.00",
        "currencyCode": "USD",
        "indicator": "CL"
      },
      "transactionFootPrint": {
        "mcc": 5962,
        "carbonEmissionInGrams": 27.98,
        "carbonEmissionInOunces": 0.99,
        "category": {
          "mainCategory": "Shopping",
          "subCategory": "Department Store",
          "sector": "Specialty Retail & Services",
          "sectorCode": "302"
        },
        "scoreReference": "MCC"
      }
    }
  ]
}
```

### Test Case: Success-Invalid request parameter {#test-case-success-invalid-request-parameter}

##### Response {#response-1}

```json
{
  "Errors": {
    "Error": [
      {
        "Source": "Service-Provider-Mgmt",
        "ReasonCode": "INVALID_REQUEST_PARAMETER",
        "Description": "Payment card is not registered.",
        "Recoverable": false,
        "Details": ""
      }
    ]
  }
}
```

### Test Case: Success-Invalid date range {#test-case-success-invalid-date-range}

##### Response {#response-2}

```json
{
  "Errors": {
    "Error": [
      {
        "Source": "Service-Provider-Mgmt",
        "ReasonCode": "INVALID_DATE_RANGE",
        "Description": "Requested date range is either invalid or exceeds one year limit. Try again with valid date range.",
        "Recoverable": false,
        "Details": ""
      }
    ]
  }
}
```