> ## Documentation Index > Fetch the complete documentation index at: https://docs.qash.ai/llms.txt > Use this file to discover all available pages before exploring further. # List card transactions > Return transaction history for the authenticated user's card. Requires `Authorization: Bearer ` — the token from [Verify login code](/api-reference/users/verify-otp). Use the query parameters to filter by card, transaction type, page size, or pagination cursor. ## OpenAPI ````yaml api-reference/openapi.json GET /api/v1/cards/transactions openapi: 3.1.0 info: title: QASH API description: >- QASH endpoints for exchange rates, cards, and partner-facing financial workflows. version: 1.0.0 servers: - url: https://api.qash.ai description: Partner API (Production) - url: https://staging.qash.ai description: Staging - url: https://app.qash.ai description: Production security: [] tags: - name: Exchange rates description: Public endpoints for supported assets and TRM-based quotes. - name: Cards description: >- Authenticated partner endpoints for card state, controls, limits, and balances. - name: Users description: Admin endpoints for user provisioning and account management. paths: /api/v1/cards/transactions: get: tags: - Cards summary: List card transactions description: >- Returns transaction history for the authenticated user's card. You can filter by card, type, or pagination cursor. operationId: listCardTransactions parameters: - name: cardId in: query required: false description: Filter by a specific card identifier. schema: type: string format: uuid - name: type in: query required: false description: Filter by transaction type. schema: type: string - name: limit in: query required: false description: Maximum number of results to return. Defaults to 50. schema: type: integer minimum: 1 default: 50 - name: cursor in: query required: false description: Pagination cursor from a previous response. schema: type: string responses: '200': description: Transaction history returned successfully. content: application/json: schema: $ref: '#/components/schemas/CardTransactionsResponse' example: items: - id: txn_a1b2c3d4e5f6 type: spend spend: amount: 45 currency: USD localAmount: 45 localCurrency: USD authorizedAmount: 45 authorizationMethod: chip memo: null receipt: false merchantName: Amazon merchantCategory: Online Retail merchantCategoryCode: '5999' merchantId: merchant_xyz enrichedMerchantIcon: https://logo.clearbit.com/amazon.com enrichedMerchantName: Amazon enrichedMerchantCategory: Shopping cardId: card-uuid-1234 cardType: virtual companyId: company-uuid-5678 userId: user-uuid-9012 userFirstName: John userLastName: Doe userEmail: john@company.com status: completed declinedReason: null authorizedAt: '2024-01-15T10:30:00Z' postedAt: '2024-01-16T08:00:00Z' nextCursor: eyJpZCI6InR4bl9hMWIyYzNkNGU1ZjYifQ== '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/CardNotFound' security: - bearerAuth: [] components: schemas: CardTransactionsResponse: type: object properties: items: type: array items: $ref: '#/components/schemas/CardTransaction' nextCursor: type: - string - 'null' description: >- Opaque cursor for retrieving the next page of results. Null when there are no more pages. example: eyJpZCI6InR4bl9hMWIyYzNkNGU1ZjYifQ== required: - items CardTransaction: type: object properties: id: type: string description: Unique transaction identifier. example: txn_a1b2c3d4e5f6 type: type: string description: Transaction type. Currently `spend` is the primary type. example: spend spend: $ref: '#/components/schemas/SpendTransactionDetails' required: - id - type - spend SpendTransactionDetails: type: object properties: amount: type: number description: Transaction amount in the billing currency. example: 45 currency: type: string description: Billing currency code (ISO 4217). example: USD localAmount: type: - number - 'null' description: >- Amount in the local currency at the point of sale. Null when not available. example: 45 localCurrency: type: - string - 'null' description: >- Local currency code at the point of sale (ISO 4217). Null when not available. example: USD authorizedAmount: type: - number - 'null' description: >- Amount that was authorized. May differ from the final settled amount. Null when not available. example: 45 authorizationMethod: type: - string - 'null' description: >- Method used to authorize the transaction (e.g. `chip`, `contactless`, `online`). Null when not available. example: chip memo: type: - string - 'null' description: Free-text memo attached to the transaction. Null when absent. example: null receipt: type: boolean description: Whether a receipt has been attached to this transaction. example: false merchantName: type: string description: Raw merchant name as reported by the card network. example: Amazon merchantCategory: type: string description: Merchant category label derived from the MCC. example: Online Retail merchantCategoryCode: type: string description: ISO 18245 Merchant Category Code (MCC). example: '5999' merchantId: type: - string - 'null' description: Internal merchant identifier. Null when not available. example: merchant_xyz enrichedMerchantIcon: type: - string - 'null' format: uri description: URL to the enriched merchant logo. Null when not available. example: https://logo.clearbit.com/amazon.com enrichedMerchantName: type: - string - 'null' description: Cleaned-up merchant name from enrichment. Null when not available. example: Amazon enrichedMerchantCategory: type: - string - 'null' description: Enriched merchant category label. Null when not available. example: Shopping cardId: type: string format: uuid description: UUID of the card used for this transaction. example: card-uuid-1234 cardType: type: string description: Type of card (`virtual` or `physical`). example: virtual companyId: type: string format: uuid description: UUID of the company associated with the card. example: company-uuid-5678 userId: type: string format: uuid description: UUID of the user who made the transaction. example: user-uuid-9012 userFirstName: type: string description: First name of the cardholder. example: John userLastName: type: - string - 'null' description: Last name of the cardholder. Null when not available. example: Doe userEmail: type: string format: email description: Email address of the cardholder. example: john@company.com status: type: string description: Transaction status. enum: - pending - completed - declined - reversed example: completed declinedReason: type: - string - 'null' description: >- Reason the transaction was declined. Present only when `status` is `declined`, null otherwise. example: null authorizedAt: type: string format: date-time description: Timestamp when the transaction was authorized (ISO 8601). example: '2024-01-15T10:30:00Z' postedAt: type: - string - 'null' format: date-time description: >- Timestamp when the transaction was posted/settled (ISO 8601). Null while still pending. example: '2024-01-16T08:00:00Z' required: - amount - currency - receipt - merchantName - merchantCategory - merchantCategoryCode - cardId - cardType - companyId - userId - userFirstName - userEmail - status - authorizedAt responses: Unauthorized: description: Invalid or expired JWT. CardNotFound: description: The authenticated user does not have a registered card. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````