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

# Get Transaction

> Get details of a specific business wallet transaction by ID — category, amount, fee, status, and description. GET /account/transactions/{id}.

## Overview

Retrieve details of a specific transaction from your business account by its transaction ID.

## Path Parameters

| Parameter       | Type   | Description                                                        |
| --------------- | ------ | ------------------------------------------------------------------ |
| `transactionId` | string | Transaction batch ID (e.g. `FYB69F984AA38EFB`, `DEP69FE561280613`) |

## Response Fields

| Field           | Type   | Description                                                                                                             |
| --------------- | ------ | ----------------------------------------------------------------------------------------------------------------------- |
| `transactionId` | string | Unique transaction batch ID                                                                                             |
| `reference`     | string | Card ID, payment reference, or on-chain hash                                                                            |
| `type`          | string | `CREDIT` or `DEBIT`                                                                                                     |
| `category`      | string | `DEPOSIT`, `WITHDRAW`, `ISSUANCE`, `FUNDING`, `UNLOADING`, `TERMINATION`, `TRANSFER`, `COLLECTION`, `PAYOUT`, `AIRTIME` |
| `amount`        | number | Transaction amount                                                                                                      |
| `fee`           | number | Fee charged                                                                                                             |
| `currency`      | string | `USD` or `USDT` for crypto deposits                                                                                     |
| `status`        | string | `PENDING`, `COMPLETED`, `FAILED`, or `PROCESSING`                                                                       |
| `description`   | string | Cardholder name, counterparty, or asset name                                                                            |
| `createdAt`     | string | ISO 8601 timestamp                                                                                                      |
| `updatedAt`     | string | ISO 8601 timestamp of last status change                                                                                |

## Example Usage

```javascript theme={null}
const response = await fetch('https://api.fyatu.com/api/v3/account/transactions/FYB69E67E1B227D5', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const { data } = await response.json();

console.log(`Transaction: ${data.transactionId}`);
console.log(`Type: ${data.type} (${data.category})`);
console.log(`Amount: $${data.amount}, Fee: $${data.fee}`);
console.log(`Status: ${data.status}`);
console.log(`Description: ${data.description}`);
```

## Use Cases

1. **Verify a credit**: Confirm a deposit or collection payment landed in your wallet
2. **Card funding confirmation**: Verify that a card funding operation was settled
3. **Audit trail**: Inspect fee and counterparty details for any transaction


## OpenAPI

````yaml v3/openapi.json GET /account/transactions/{transactionId}
openapi: 3.1.0
info:
  title: FYATU API v3
  description: >-
    FYATU API v3 with JWT authentication for Collections, Payouts, and Card
    Issuing.
  version: 3.0.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3
    description: Production
security: []
tags:
  - name: Authentication
    description: JWT token management endpoints
  - name: Account
    description: Business account, wallet, and address management
  - name: Collections
    description: Accept payments from customers via checkout sessions
  - name: Refunds
    description: Issue refunds for completed collections
  - name: Payouts
    description: Send money to Fyatu account holders
  - name: Cardholders
    description: Cardholder management for card issuing programs
  - name: Cards
    description: Issue, fund, freeze, and manage virtual cards
  - name: Webhooks
    description: Webhook configuration and management
paths:
  /account/transactions/{transactionId}:
    get:
      tags:
        - Account
      summary: Get Transaction
      description: >-
        Retrieve details of a specific transaction by its ID (batch) or
        reference.
      operationId: getTransaction
      parameters:
        - name: transactionId
          in: path
          required: true
          description: Transaction ID (batch) or reference
          schema:
            type: string
      responses:
        '200':
          description: Transaction retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetailResponse'
              example:
                success: true
                status: 200
                message: Transaction retrieved successfully
                data:
                  transactionId: FYB69F984AA38EFB
                  reference: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1
                  type: DEBIT
                  category: FUNDING
                  amount: 50
                  fee: 0.5
                  currency: USD
                  status: COMPLETED
                  description: Card Funding - 515253******1234 (Alice Example)
                  createdAt: '2026-05-05T09:00:00Z'
                  updatedAt: '2026-05-05T09:00:00Z'
                meta:
                  requestId: req_7af4d2b8e91c35fa4b21890e
                  timestamp: '2026-05-05T09:00:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Transaction not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                status: 404
                message: Transaction not found
                error:
                  code: RESOURCE_NOT_FOUND
      security:
        - BearerAuth: []
components:
  schemas:
    TransactionDetailResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        status:
          type: integer
          example: 200
        message:
          type: string
        data:
          $ref: '#/components/schemas/TransactionDetail'
        meta:
          $ref: '#/components/schemas/Meta'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        status:
          type: integer
          example: 401
        message:
          type: string
          example: Invalid credentials
        error:
          $ref: '#/components/schemas/Error'
        meta:
          $ref: '#/components/schemas/Meta'
    TransactionDetail:
      type: object
      properties:
        transactionId:
          type: string
          description: Unique transaction batch ID
        reference:
          type: string
          description: Card ID, payment reference, or on-chain hash
        type:
          type: string
          enum:
            - CREDIT
            - DEBIT
        category:
          type: string
          enum:
            - DEPOSIT
            - WITHDRAW
            - ISSUANCE
            - FUNDING
            - UNLOADING
            - TERMINATION
            - TRANSFER
            - COLLECTION
            - PAYOUT
            - AIRTIME
        amount:
          type: number
        fee:
          type: number
        currency:
          type: string
          description: USD or USDT for crypto deposits
        status:
          type: string
          enum:
            - PENDING
            - COMPLETED
            - FAILED
            - PROCESSING
        description:
          type: string
          description: Cardholder name, counterparty, or asset name
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    Meta:
      type: object
      properties:
        requestId:
          type: string
          description: Unique request ID for tracking
          example: req_abc123def456
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of the response
    Error:
      type: object
      properties:
        code:
          type: string
          description: Error code for programmatic handling
          example: AUTH_INVALID_CREDENTIALS
        details:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
          description: Validation error details (for VALIDATION_ERROR)
    ValidationError:
      type: object
      properties:
        field:
          type: string
          description: Field that failed validation
          example: appId
        message:
          type: string
          description: Validation error message
          example: AppId is required
  responses:
    Unauthorized:
      description: Authentication required or token invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            status: 401
            message: Unable to identify business
            error:
              code: AUTH_TOKEN_INVALID
            meta:
              requestId: req_abc123
              timestamp: '2026-01-05T10:30:00+00:00'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from /auth/token

````