# Get a transaction by ID

Retrieves a single transaction by its unique identifier.

Endpoint: GET /v1/api/transactions/{id}
Version: 1.2.4
Security: X-Api-Key

## Path parameters:

  - `id` (string, required)
    Transactions ID

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the Transactions.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `createdAt` (string)
    Timestamp when the Transactions was created.
    Example: "2025-12-07T19:31:48.436+00:00"

  - `updatedAt` (string)
    Timestamp when the Transactions was last updated.
    Example: "2025-12-07T19:35:48.436+00:00"

  - `companyId` (string)
    Company ID associated with the Transactions.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `externalId` (string)
    External ID of the transaction.
    Example: "ext_txn_123"

  - `paymentMethod` (string)
    Payment method used for the transaction.
    Example: "credit_card"

  - `amount` (string)
    Amount of the transaction.
    Example: "100.00"

  - `currency` (string)
    Currency of the transaction.
    Example: "USD"

  - `type` (string)
    Type of the transaction.
    Example: "sale"

  - `notes` (string)
    Notes for the transaction.
    Example: "Customer paid in full"

  - `employee` (string)
    Employee ID who processed the transaction.
    Example: "507f1f77bcf86cd799439011"

  - `balance` (string)
    Balance after the transaction.
    Example: "0.00"

  - `sessionId` (string)
    Session ID associated with the transaction.
    Example: "507f1f77bcf86cd799439012"

  - `paymentData` (object)
    Payment processor data for the transaction.
    Example: {"processor":"stripe","processorTransactionId":"pi_123","device":"terminal_001"}

  - `paymentData.processor` (string)
    Payment processor name.
    Example: "stripe"

  - `paymentData.processorTransactionId` (string)
    Transaction ID from the processor.
    Example: "pi_123"

  - `paymentData.device` (string)
    Device used for the transaction.
    Example: "terminal_001"

  - `paymentData.processorData` (string)
    Additional processor data.
    Example: "{}"

  - `paymentData.processorFee` (string)
    Fee charged by the processor.
    Example: "0.30"

  - `orderId` (string)
    Order ID associated with the transaction.
    Example: "507f1f77bcf86cd799439013"

  - `refundId` (string)
    Refund ID associated with the transaction.
    Example: "507f1f77bcf86cd799439014"

  - `outletId` (string)
    Outlet ID where the transaction occurred.
    Example: "507f1f77bcf86cd799439015"

  - `receiptId` (string)
    Receipt ID for the transaction.
    Example: "RCP-2025-001"

## Response 400 fields (application/json):

  - `statusCode` (number, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message describing what went wrong
    Example: "Validation failed: Field `schemaField` is required."

  - `error` (string, required)
    Error type/name
    Enum: "Bad Request", "Unauthorized", "Forbidden", "Not Found", "Conflict", "Unprocessable Entity", "Internal Server Error"

## Response 404 fields (application/json):

  - `statusCode` (number, required)
    HTTP status code
    Example: 404

  - `message` (string, required)
    Error message describing what went wrong
    Example: "The resource was not found."

  - `error` (string, required)
    Error type/name
    Enum: "Bad Request", "Unauthorized", "Forbidden", "Not Found", "Conflict", "Unprocessable Entity", "Internal Server Error"