> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withconvexity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Transaction

> Fetches a single token transaction by its reference.



## OpenAPI

````yaml GET /v1/tokens/transactions/{ref}
openapi: 3.1.0
info:
  title: Convexity Infra API
  version: 1.0.0
  description: >-
    REST API reference for Convexity Infra: the backend services your business
    integrates to build and operate on-chain products. Every response is wrapped
    in a `{ status, message, data }` envelope and authorized with an OAuth 2.0
    bearer token minted by Auth-Edge.
  contact:
    name: Convexity Infra
    url: https://withconvexity.com
    email: infra@withconvexity.com
servers:
  - url: https://api.convexity.tools
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Auth-Edge
    description: >-
      OAuth 2.0 token issuance. Exchange a project API key for a short-lived
      bearer token that authorizes every other Infra API call.
  - name: Projects
    description: >-
      Manage the calling project itself: rotate its API key pair and control
      which IP addresses may authenticate with it.
  - name: Payments
    description: >-
      List project and subscription payments, and mint virtual bank accounts
      (via KoraPay) for wallet top-ups and subscriptions.
  - name: Products
    description: >-
      Browse the products and capabilities available to your project. Each
      product maps to a plan and a set of capability keys.
  - name: Subscriptions
    description: List available plans and manage your project's subscriptions.
  - name: Wallet
    description: >-
      HD wallet lifecycle, balances, transfers, transaction signing, and
      supported-chain discovery. Wallets are scoped to the business in your
      token: accessing another business's wallet returns `403`.


      **Capabilities**: each operation is gated on a capability granted by your
      plan; a missing one returns `403: Missing required capability:
      <capability>`.


      | Capability | Grants |

      |---|---|

      | `wallet.hd.generate` | Generate wallets. |

      | `wallet.hd.read` | List and read wallets, counts, and HD status. |

      | `wallet.hd.sign` | Sign transactions. |

      | `wallet.hd.deactivate` | Deactivate a wallet. |

      | `wallet.transfer.create` | Initiate transfers. |

      | `wallet.transfer.read` | Read transaction history and records. |

      | `wallet.balance.read` | Read the USD balance. |
  - name: Indexer
    description: >-
      Subscribe to decoded on-chain events, receive signed webhooks, and inspect
      or replay delivery logs. Every endpoint requires a token with project +
      business context and a per-operation capability.
  - name: Tokenization
    description: >-
      Issue and manage tokenized real-world assets: create tokens, mint, burn,
      transfer, manage holders and registered wallets, and run yield operations
      (coupons, distributions, claims, and principal redemption).
paths:
  /v1/tokens/transactions/{ref}:
    get:
      tags:
        - Tokenization
      summary: Get Transaction
      description: Fetches a single token transaction by its reference.
      operationId: getTokenTransaction
      parameters:
        - name: ref
          in: path
          required: true
          schema:
            type: string
          description: Transaction reference (`operationRef` or id).
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              example:
                status: true
                message: Transaction retrieved successfully
                data:
                  id: 019edeb3-55c4-770e-9dbc-d1c61fb90bc1
                  tokenId: 019edea4-e84d-722d-94ec-cb0fd331693d
                  chain: BASE
                  projectId: 6a171d8571dd1e1496b3f290
                  type: BURN
                  status: CONFIRMED
                  fromAddress: '0x19F538a73e26F90cd8F76fb362B909B169df4E44'
                  amount: '50'
                  txHash: >-
                    0xd4282642582ef0c458d78ca21891b11742b4c6483c1acf949584265e200ae7fb
                  blockNumber: 43042237
                  blockHash: >-
                    0x949d50919d5f1804bd86f9df7562fac6fede74176723309c9db1ed0c5a986f64
                  gasUsed: '104073'
                  feeWei: '749325600000'
                  operationRef: burn_6734f2528ba9bce9ff246775137d3b8d
                  memo: Investor exit
                  createdAt: '2026-06-19T07:05:55.396Z'
                  confirmedAt: '2026-06-19T07:06:12.973Z'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth 2.0 access token from Auth-Edge.

````