> ## 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 > Retrieves paginated transactions for all activated cards of the authenticated user. Returns three types of transaction events: - **Payment**: Regular card transactions (purchases, ATM withdrawals). Can appear immediately after authorization with `isPending: true`, then update when cleared. - **Refund**: Money returned to your account (product returns, cancellations). Only appears after both authorization and clearing are processed. - **Reversal**: Cancellation of previous transactions due to technical issues or merchant corrections. Can appear immediately after authorization-level reversals. The final number might differ slightly, as one thread might contain multiple transactions. ## OpenAPI ````yaml https://api.gnosispay.com/api-docs/spec.json get /api/v1/cards/transactions openapi: 3.0.0 info: title: GnosisPay API version: 1.0.0 description: OpenAPI documentation for GnosisPay servers: - url: https://api.gnosispay.com security: [] tags: - name: Account Management description: Information about your Account - name: Authentication description: Authenticate to our API using SIWE - name: Card Management description: Manage all your Cards - name: IBAN description: Integrate with Monerium to issue IBANs - name: KYC description: KYC using Sumsub SDK - name: Physical Card Order description: Order a Physical Card and manage the process - name: Rewards description: Cashback Rewards - name: Safe Management description: Manage your Safe - name: Transactions description: Manage Card Transactions - name: User description: Manage User Information - name: Webhooks description: Manage Webhooks paths: /api/v1/cards/transactions: get: tags: - Transactions summary: List Card Transactions description: > Retrieves paginated transactions for all activated cards of the authenticated user. Returns three types of transaction events: - **Payment**: Regular card transactions (purchases, ATM withdrawals). Can appear immediately after authorization with `isPending: true`, then update when cleared. - **Refund**: Money returned to your account (product returns, cancellations). Only appears after both authorization and clearing are processed. - **Reversal**: Cancellation of previous transactions due to technical issues or merchant corrections. Can appear immediately after authorization-level reversals. The final number might differ slightly, as one thread might contain multiple transactions. parameters: - in: query name: cardTokens schema: type: string description: Comma-separated list of card tokens - in: query name: limit schema: type: integer default: 100 minimum: 10 description: Maximum number of transactions to return - in: query name: offset schema: type: integer default: 0 minimum: 0 description: Number of transactions to skip - in: query name: before schema: type: string format: date-time description: >- Filter transactions before this date (ISO 8601 format, e.g., "2023-04-01T00:00:00Z") - in: query name: after schema: type: string format: date-time description: >- Filter transactions after this date (ISO 8601 format, e.g., "2023-03-01T00:00:00Z") - in: query name: billingCurrency schema: type: string description: Filter by billing currency code - in: query name: transactionCurrency schema: type: string description: Filter by transaction currency code - in: query name: mcc schema: type: string description: Filter by Merchant Category Code (MCC) - in: query name: transactionType schema: type: string description: >- Filter by transaction type code (e.g., "00" for Purchase, "01" for Withdrawal) responses: '200': description: Successful response with paginated transaction events content: application/json: schema: type: object properties: count: type: integer description: Total number of transactions available example: 25 next: type: string nullable: true description: URL for the next page of results, null if no more pages example: /api/v1/cards/transactions?limit=100&offset=100 previous: type: string nullable: true description: >- URL for the previous page of results, null if on first page example: null results: type: array description: Array of transaction events for the current page items: $ref: '#/components/schemas/Event' examples: payment_pending: summary: Payment (Pending) description: A pending card payment that hasn't been cleared yet value: - createdAt: '2024-01-15T14:30:00Z' clearedAt: null isPending: true kind: Payment status: Approved country: name: United Kingdom numeric: '826' alpha2: GB alpha3: GBR mcc: '5411' merchant: name: TESCO STORES city: LONDON country: name: United Kingdom alpha2: GB billingAmount: '2550' billingCurrency: symbol: € code: EUR decimals: 2 name: Euro transactionAmount: '2199' transactionCurrency: symbol: £ code: GBP decimals: 2 name: British Pound transactionType: '00' cardToken: 4532********1234 transactions: - status: ExecSuccess to: '0x1234567890abcdef1234567890abcdef12345678' value: '2550000000000000000000' data: '0xa9059cbb' hash: >- 0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890 payment_cleared: summary: Payment (Cleared) description: A cleared card payment that has been settled value: - createdAt: '2024-01-14T09:15:00Z' clearedAt: '2024-01-15T02:30:00Z' isPending: false kind: Payment status: Approved country: name: Germany numeric: '276' alpha2: DE alpha3: DEU mcc: '5814' merchant: name: STARBUCKS city: BERLIN country: name: Germany alpha2: DE billingAmount: '450' billingCurrency: symbol: € code: EUR decimals: 2 name: Euro transactionAmount: '450' transactionCurrency: symbol: € code: EUR decimals: 2 name: Euro transactionType: '00' cardToken: 4532********1234 transactions: - status: ExecSuccess to: '0x1234567890abcdef1234567890abcdef12345678' value: '450000000000000000000' data: '0xa9059cbb' hash: >- 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef refund: summary: Refund description: A refund transaction returning money to the account value: - createdAt: '2024-01-13T16:45:00Z' clearedAt: '2024-01-14T08:20:00Z' isPending: false kind: Refund country: name: France numeric: '250' alpha2: FR alpha3: FRA mcc: '5651' merchant: name: H&M PARIS city: PARIS country: name: France alpha2: FR billingAmount: '7500' billingCurrency: symbol: € code: EUR decimals: 2 name: Euro transactionAmount: '7500' transactionCurrency: symbol: € code: EUR decimals: 2 name: Euro transactionType: '20' cardToken: 4532********1234 refundAmount: '7500' refundCurrency: symbol: € code: EUR decimals: 2 name: Euro transactions: - status: ExecSuccess to: '0x1234567890abcdef1234567890abcdef12345678' value: '7500000000000000000000' data: '0xa9059cbb' hash: >- 0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba reversal: summary: Reversal description: A transaction reversal canceling a previous payment value: - createdAt: '2024-01-12T11:20:00Z' clearedAt: '2024-01-12T11:25:00Z' isPending: false kind: Reversal country: name: Netherlands numeric: '528' alpha2: NL alpha3: NLD mcc: '5999' merchant: name: ONLINE STORE city: AMSTERDAM country: name: Netherlands alpha2: NL billingAmount: '1200' billingCurrency: symbol: € code: EUR decimals: 2 name: Euro transactionAmount: '1200' transactionCurrency: symbol: € code: EUR decimals: 2 name: Euro transactionType: '00' cardToken: 4532********1234 reversalAmount: '1200' reversalCurrency: symbol: € code: EUR decimals: 2 name: Euro transactions: - status: ExecSuccess to: '0x1234567890abcdef1234567890abcdef12345678' value: '1200000000000000000000' data: '0xa9059cbb' hash: >- 0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321 '401': $ref: '#/components/responses/UnauthorizedError' '500': $ref: '#/components/responses/InternalServerError' security: - bearerAuth: [] components: schemas: Event: oneOf: - $ref: '#/components/schemas/Payment' - $ref: '#/components/schemas/Refund' - $ref: '#/components/schemas/Reversal' Payment: allOf: - $ref: '#/components/schemas/BasePaymentish' - type: object properties: kind: type: string enum: - Payment status: type: string enum: - Approved - IncorrectPin - InsufficientFunds - ExceedsApprovalAmountLimit - InvalidAmount - PinEntryTriesExceeded - IncorrectSecurityCode - Reversal - PartialReversal - Other Refund: allOf: - $ref: '#/components/schemas/BasePaymentish' - type: object properties: kind: type: string enum: - Refund refundAmount: type: string description: A BigInt value represented as a string refundCurrency: $ref: '#/components/schemas/Currency' Reversal: allOf: - $ref: '#/components/schemas/BasePaymentish' - type: object properties: kind: type: string enum: - Reversal reversalAmount: type: string description: A BigInt value represented as a string reversalCurrency: $ref: '#/components/schemas/Currency' Error: type: object properties: error: type: string description: Error message example: Internal server error BasePaymentish: type: object properties: threadId: type: string description: Thread ID for the transaction example: '1234567890' createdAt: type: string format: date-time clearedAt: type: string format: date-time nullable: true description: Date of the latest clearing record of the transaction country: $ref: '#/components/schemas/Country' isPending: type: boolean description: > Whether the transaction is pending settlement. - For Payments: true when authorized but not yet cleared, false when settled - For Refunds: can be true if additional clearing steps are pending, typically false since they require both auth + clearing to appear - For Reversals: typically false as they're usually processed quickly impactsCashback: type: boolean nullable: true description: > Indicates whether this transaction impacted cashback eligibility: - `true`: Transaction was eligible for and impacted cashback - `false`: Transaction did not impact cashback (not eligible) - `null`: Unable to determine (e.g., before user accepted cashback terms) mcc: type: string merchant: type: object properties: name: type: string city: type: string country: $ref: '#/components/schemas/Country' billingAmount: type: string description: A BigInt value represented as a string billingCurrency: $ref: '#/components/schemas/Currency' transactionAmount: type: string description: A BigInt value represented as a string transactionCurrency: $ref: '#/components/schemas/Currency' transactionType: type: string description: > First 2 digits of the DE3 field (ISO 8583), representing the transaction type code. Common values include (not limited to): - "00": Purchase (POS) - "01": Withdrawal (ATM) - "10": Account Funding - "20": Return of Goods - "28": Prepaid Load - "30": Balance Inquiry - "70": PIN Change - "72": PIN Unblock cardToken: type: string description: The token identifying the card used for this transaction transactions: type: array items: $ref: '#/components/schemas/Transaction' Currency: type: object properties: symbol: type: string code: type: string decimals: type: integer name: type: string Country: type: object properties: name: type: string numeric: type: string alpha2: type: string alpha3: type: string Transaction: type: object properties: status: type: string enum: - Unsubmitted - Unconfirmed - ExecReverted - ExecSuccess to: type: string value: type: string description: A BigInt value represented as a string data: type: string hash: type: string nullable: true responses: UnauthorizedError: description: Unauthorized Error content: application/json: schema: type: object properties: message: type: string InternalServerError: description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````