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

# Retrieve a Transaction

> Retrieve a single transaction by ID, including its balance changes and status.

**GET** `/api/external/transactions/{transactionId}/`

## Path parameter

<ParamField path="transactionId" type="string" required>
  ID returned by a transaction create or list response.
</ParamField>

## Response

Returns the [Transaction](/api-basics/data-models#transaction). Its `status` is the lifecycle source of truth.

<RequestExample dropdown>
  ```json Request example theme={null}
  {
    "path": {
      "transactionId": "transaction_123"
    }
  }
  ```

  ```bash cURL theme={null}
  # Sample only. Generate a new signed token for each request
  # (see Authentication). Tokens expire after 120 seconds.
  curl --request GET \
    --url "https://api.primevault.com/api/external/transactions/transaction_123/" \
    --header "Authorization: Bearer <signed JWT>" \
    --header "Api-Key: <API key>" \
    --header "Accept: application/json"
  ```

  ```typescript JavaScript SDK theme={null}
  getTransactionById(transactionId: string): Promise<Transaction>
  ```
</RequestExample>

<ResponseExample>
  ```json JSON example theme={null}
  {
    "id": "transaction_123",
    "orgId": "org_456",
    "vaultId": "vault_123",
    "status": "COMPLETED",
    "transactionType": "OUTGOING",
    "category": "TRANSFER",
    "subCategory": "EXTERNAL_TRANSFER",
    "createdAt": "2026-08-04T10:40:00Z",
    "updatedAt": "2026-08-04T10:42:15Z",
    "isDeleted": false,
    "externalId": "invoice-1001",
    "memo": "Vendor payout #1001",
    "source": {
      "type": "VAULT",
      "id": "vault_123",
      "subOrgId": "sub_org_123",
      "name": "Treasury Vault"
    },
    "destination": {
      "type": "CONTACT",
      "id": "contact_456",
      "name": "Operations Wallet",
      "address": "0xAbC1234567890abcdef1234567890abcdef1234",
      "chain": "ETHEREUM"
    },
    "blockChain": "ETHEREUM",
    "asset": "ETH",
    "amount": "0.50",
    "txHash": "0x9f4e6c1b7a2d3e4f",
    "balanceChanges": {
      "changes": [
        {
          "party": {
            "type": "VAULT",
            "id": "vault_123",
            "subOrgId": "sub_org_123",
            "name": "Treasury Vault"
          },
          "asset": "ETH",
          "amount": "-0.50",
          "chain": "ETHEREUM"
        },
        {
          "party": {
            "type": "CONTACT",
            "id": "contact_456",
            "name": "Operations Wallet",
            "address": "0xAbC1234567890abcdef1234567890abcdef1234",
            "chain": "ETHEREUM"
          },
          "asset": "ETH",
          "amount": "0.50",
          "chain": "ETHEREUM"
        }
      ]
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.