> ## 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. # Get a card transaction > Retrieves one card-payment lifecycle by ID. The amount semantics are identical to the list route: `amounts.billing` describes the account impact and `amounts.merchant` describes the amount in the merchant or acquirer's currency when available. ## OpenAPI ````yaml https://core.sandbox.gnosispay.in/partner-api/openapi.json get /v1/card-transactions/{card_transaction_id} 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/{card_transaction_id}: get: tags: - Card transactions summary: Get a card transaction description: >- Retrieves one card-payment lifecycle by ID. The amount semantics are identical to the list route: `amounts.billing` describes the account impact and `amounts.merchant` describes the amount in the merchant or acquirer's currency when available. operationId: card_transactions.get.v1 parameters: - name: card_transaction_id in: path required: true description: The card transaction ID. schema: $ref: '#/components/schemas/uuid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CardTransaction' 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. 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.