---
title: "Get transaction by ID"
method: GET
path: "/transactions/{transactionId}"
tags: ["Transactions"]
---

# Get transaction by ID

`GET /transactions/{transactionId}`

Retrieve detailed information about a specific transaction.

## Response `200`

Successful operation

- Transaction
  - `id` string, required — Unique identifier for the transaction
  - `status` 'CREATED' | 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'REJECTED' | 'FAILED' | 'REFUNDED' | 'EXPIRED', required — Status of a payment transaction
  - `type` 'INCOMING' | 'OUTGOING', required — Type of transaction (incoming payment or outgoing payment)
  - `destination` union, required
    - AccountTransactionDestination — Destination account details
      - `currency` string — Currency code for the destination
      - `destinationType` 'ACCOUNT', required
      - `accountId` string, required — Destination account identifier
    - UmaAddressTransactionDestination — UMA address destination details
      - `currency` string — Currency code for the destination
      - `destinationType` 'UMA_ADDRESS', required
      - `umaAddress` string, required — UMA address of the recipient
  - `customerId` string, required — System ID of the customer (sender for outgoing, recipient for incoming)
  - `platformCustomerId` string, required — Platform-specific ID of the customer (sender for outgoing, recipient for incoming)
  - `settledAt` string, date-time — When the payment was or will be settled
  - `createdAt` string, date-time — When the transaction was created
  - `updatedAt` string, date-time — When the transaction was last updated
  - `description` string — Optional memo or description for the payment
  - `counterpartyInformation` object — Additional information about the counterparty, if available and relevant to the transaction and platform. Only applicable for transactions to/from UMA addresses.

## Other responses

- `401` — Unauthorized
- `404` — Transaction not found
- `500` — Internal service error

## Changes

- **2026-02-07** `e951665c552d` — 2 breaking, 2 info
  - removed the required property `destination/oneOf[subschema #1: Account Destination]/allOf[#/components/schemas/BaseTransactionDestination]/destinationType` from the response with the `200` status
  - removed the required property `destination/oneOf[subschema #2: UMA Address Destination]/allOf[#/components/schemas/BaseTransactionDestination]/destinationType` from the response with the `200` status
  - the response property `destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/destinationType` became required for the status `200`
  - the response property `destination/oneOf[subschema #2: UMA Address Destination]/allOf[subschema #2]/destinationType` became required for the status `200`
- **2026-02-06** `9d1655bef82d` — 2 breaking
  - the response property `destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/destinationType` became optional for the status `200`
  - the response property `destination/oneOf[subschema #2: UMA Address Destination]/allOf[subschema #2]/destinationType` became optional for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/transactions/:transactionId/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/revisions/a3bb103c6b4a/schema)