---
title: "POST /card/transaction-history"
method: POST
path: "/card/transaction-history"
tags: ["Account"]
---

# POST /card/transaction-history

`POST /card/transaction-history`

Transaction History

## Headers

- `X-GD-RequestId` string, required

## Request body

- TransactionHistoryRequest
  - `startDate` string, date-time, nullable, required
  - `endDate` string, date-time, nullable, required
  - `accountNumber` string, nullable
  - `accountIdentifier` string, uuid, nullable
  - `metadata` RequestMetadata, required
    - `requestId` string, required
    - `storeId` string, required
    - `merchantId` string, required
    - `userId` string, required
    - `requestDateTime` string, date-time, nullable, required
    - `registerId` string
    - `sourceProgramCode` string
    - `options` object

## Response `200`

Transaction history response

- TransactionHistoryResponse
  - `beginningBalance` number, double, nullable
  - `endingBalance` number, double, nullable
  - `transactions` Transaction[], nullable
    - `transactionIdentifier` string, nullable
    - `transactionType` string, nullable
    - `transactionStatus` string, nullable
    - `authorizationDate` string, date-time, nullable
    - `authorizationAmount` number, double, nullable
    - `category` string, nullable
    - `merchantID` string, nullable
    - `merchantName` string, nullable
    - `merchantCity` string, nullable
    - `merchantState` string, nullable
    - `merchantZipCode` string, nullable
    - `merchantCategory` string, nullable
    - `mCCCode` string, nullable
    - `runningBalance` number, double, nullable
    - `creditPosted` number, double, nullable
    - `debitPosted` number, double, nullable
    - `transactionDescription` string, nullable
    - `transactionCode` string, nullable
    - `postedDate` string, date-time, nullable
    - `declinedCode` string, nullable
    - `declinedCodeDescription` string, nullable
    - `declineReasonDescription` string, nullable
  - `metadata` ResponseMetadata
    - `requestId` string
    - `responseId` string
    - `responseDateTime` string, date-time
    - `responseCode` integer
    - `responseDescription` string

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/revisions/666553766b78/schema)