> ## Documentation Index > Fetch the complete documentation index at: https://docs.gnosispay.com/llms.txt > Use this file to discover all available pages before exploring further. # List card transactions > Lists card-payment lifecycles for one account, newest first. Each item is one aggregate card-payment lifecycle, not an individual card network event. Amounts and status can change as an authorization is cleared, reversed, cancelled, or declined. `amounts.billing` is the current amount reserved or posted against the account, in the account's billing currency. `amounts.merchant` is the current amount in the merchant or acquirer's currency and is null when that information was not supplied. Never substitute the billing amount for a missing merchant amount. ## OpenAPI ````yaml https://core.sandbox.gnosispay.in/partner-api/openapi.json get /v1/card-transactions openapi: 3.1.0 info: title: Gnosis Pay Partner API version: 1.0.0 description: >- Server-to-server API for onboarding users, creating accounts and cards, moving funds, and managing the card lifecycle. Call this API only from a trusted backend. Every request requires a partner access token, and every resource is scoped to the authenticated partner. servers: - url: https://core.prod.gnosispay.com/partner-api description: Production variables: {} - url: https://core.sandbox.gnosispay.in/core description: Sandbox variables: {} security: - BearerAuth: [] tags: - name: Accounts - name: Cards - name: Card transactions - name: KYC - name: Deposits - name: Withdrawals - name: PCI - name: 3DS - name: Webhooks paths: /v1/card-transactions: get: tags: - Card transactions summary: List card transactions description: >- Lists card-payment lifecycles for one account, newest first. Each item is one aggregate card-payment lifecycle, not an individual card network event. Amounts and status can change as an authorization is cleared, reversed, cancelled, or declined. `amounts.billing` is the current amount reserved or posted against the account, in the account's billing currency. `amounts.merchant` is the current amount in the merchant or acquirer's currency and is null when that information was not supplied. Never substitute the billing amount for a missing merchant amount. operationId: card_transactions.list.v1 parameters: - name: account_id in: query required: true description: >- Account whose card transactions are returned. The account must belong to the authenticated partner. schema: $ref: '#/components/schemas/uuid' explode: false - name: created_at_start in: query required: false description: Return transactions created at or after this time. schema: type: string format: date-time explode: false - name: created_at_end in: query required: false description: Return transactions created at or before this time. schema: type: string format: date-time explode: false - name: page_size in: query required: false description: The number of card transactions on each page (1-100). schema: type: integer format: int32 minimum: 1 maximum: 100 default: 10 explode: false - name: page_cursor in: query required: false description: >- The cursor of the page to return. Its value comes from `pagination.next_page_cursor` in the previous response. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: type: object required: - data - pagination properties: data: type: array items: $ref: '#/components/schemas/CardTransaction' pagination: $ref: '#/components/schemas/PaginationInfo' description: Paginated response containing data and pagination metadata examples: Foreign-currency card transaction: summary: Foreign-currency card transaction description: >- The account is affected by 12.30 EUR while the merchant amount is 13.50 USD. value: data: - id: 019cbf60-2a4b-7c1d-8e2f-3a4b5c6d7e8f account_id: 019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f card_id: 019cbf59-3c4d-7e5f-8a6b-7c8d9e0f1a2b status: cleared direction: debit amounts: billing: amount: '1230' currency: EUR decimals: 2 merchant: amount: '1350' currency: USD decimals: 2 description: Coffee Shop merchant: name: Coffee Shop city: Berlin country: DEU category_code: '5814' authorization_code: A1B2C3 decline_reason: null created_at: '2025-06-16T09:15:00Z' updated_at: '2025-06-17T03:00:00Z' pagination: next_page_cursor: null has_next: false default: description: An unexpected error response. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: uuid: type: string format: uuid CardTransaction: type: object required: - id - account_id - card_id - status - direction - amounts - description - merchant - authorization_code - decline_reason - created_at - updated_at properties: id: $ref: '#/components/schemas/uuid' description: Card transaction ID. account_id: $ref: '#/components/schemas/uuid' description: Account affected by the card transaction. card_id: $ref: '#/components/schemas/uuid' description: Card used for the card transaction. status: $ref: '#/components/schemas/CardTransactionStatus' description: Current public lifecycle state. direction: $ref: '#/components/schemas/CardTransactionDirection' description: Whether money leaves or returns to the account. amounts: $ref: '#/components/schemas/CardTransactionAmounts' description: Current billing and merchant amounts. description: anyOf: - type: string - type: 'null' description: Human-readable card-network description, when supplied. merchant: anyOf: - $ref: '#/components/schemas/Merchant' - type: 'null' description: Merchant data, or null when no merchant data was supplied. authorization_code: anyOf: - type: string - type: 'null' description: Authorization code returned by the card network, when supplied. decline_reason: anyOf: - $ref: '#/components/schemas/DeclineReason' - type: 'null' description: Decline details. Null unless `status` is `declined`. created_at: type: string format: date-time description: When the card-payment lifecycle was first recorded. updated_at: type: string format: date-time description: When the lifecycle, status, or amounts last changed. description: One aggregate card-payment lifecycle. PaginationInfo: type: object required: - next_page_cursor - has_next properties: next_page_cursor: anyOf: - type: string - type: 'null' description: Base64-encoded cursor for the next page, null if no more items has_next: type: boolean description: True if there are more items available description: Pagination metadata for cursor-based pagination Error: type: object required: - code - message properties: code: type: integer format: int32 description: HTTP status code. message: type: string description: Generic human-readable text for the status code. Do not parse it. reason: type: string description: >- Stable machine-readable code identifying the specific cause, present only for errors that expose one (e.g. `CREATE_CARD_LIMIT_EXCEEDED`). Branch on this rather than on `message`. CardTransactionStatus: type: string enum: - authorized - cleared - reversed - cancelled - declined - unknown description: Public lifecycle state of a card transaction. CardTransactionDirection: type: string enum: - debit - credit description: >- Whether the card transaction removes money from or returns money to the account. CardTransactionAmounts: type: object required: - billing - merchant properties: billing: $ref: '#/components/schemas/MonetaryAmount' description: >- Current amount reserved or posted against the account, in the account's billing currency. It is the cleared total when clearing data exists; otherwise it is the authorized total. merchant: anyOf: - $ref: '#/components/schemas/MonetaryAmount' - type: 'null' description: >- Current amount in the merchant or acquirer's currency, following the same cleared-then-authorized rule as `billing`. Null means merchant-currency data was not supplied; clients must not fall back to `billing`. description: Account-impact and merchant-currency amounts for a card transaction. Merchant: type: object required: - name - city - country - category_code properties: name: anyOf: - type: string - type: 'null' description: Merchant display name, when supplied. city: anyOf: - type: string - type: 'null' description: Merchant city, when supplied. country: anyOf: - type: string - type: 'null' description: Merchant country code, when supplied. category_code: anyOf: - type: string - type: 'null' description: ISO 18245 merchant category code (MCC), when supplied. description: Merchant data supplied by the card network. DeclineReason: type: object required: - code - message properties: code: type: string description: Stable card-network response code. message: type: string description: Human-readable explanation of the decline code. description: >- Reason a card transaction was declined. Present only for declined transactions. MonetaryAmount: type: object required: - amount - currency - decimals properties: amount: type: string description: >- Base-10 integer string in the currency's smallest unit. For example, `1230` with 2 decimals is 12.30. currency: type: string description: ISO-4217 currency code. decimals: type: integer format: int32 description: Number of fractional digits used by the currency. description: An exact card-transaction amount in an ISO-4217 currency. securitySchemes: BearerAuth: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.