---
title: "List the legs behind a transaction"
method: GET
path: "/v1/transactions/{transactionId}/legs"
tags: ["Transactions"]
---

# List the legs behind a transaction

`GET /v1/transactions/{transactionId}/legs`

## Request

- Base URL: `https://api.sandbox.alfredpay.io`
- URL: `https://api.sandbox.alfredpay.io/v1/transactions/{transactionId}/legs`
- Auth: one of:
  - HTTP bearer
  - API key in header `api-key` and API key in header `api-secret`

Legs are where reconciliation actually happens. A cross-currency payout has two, `LP_EXECUTION` and `FIAT_RAIL`, each with its own provider, its own provider reference and its own statuses.

Without this you'd have one reference for a movement that had two, and matching against a provider statement would be guesswork.

## Response `200`

OK

- object
  - `data` PaymentLeg[]
    - `leg_id` string
    - `parent_transaction_id` string
    - `leg_type` 'LP_EXECUTION' | 'ASSET_MOVEMENT' | 'FIAT_RAIL' | 'LEDGER_ENTRY' | 'CORRECTION_LEG'
    - `provider` string
    - `provider_reference` string, nullable: Preserved as received, never overwritten.
    - `chain_tx_hash` string, nullable
    - `destination_control_type` 'ALFRED_CONTROLLED' | 'EXTERNAL_CUSTOMER_WALLET' | 'EXTERNAL_CUSTOMER_ACCOUNT' | 'EXTERNAL_UNKNOWN' | 'null', nullable
    - `leg_status` 'CREATED' | 'SUBMITTED_TO_PROVIDER' | 'ACCEPTED_BY_PROVIDER' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'RETURNED' | 'REVERSED'
    - `settlement_status` 'NOT_STARTED' | 'FUNDS_EXPECTED' | 'FUNDS_RECEIVED' | 'FUNDS_HELD' | 'FUNDS_RELEASED' | 'SETTLED' | 'PARTIALLY_SETTLED' | 'FAILED' | 'RETURNED': Leg-level and financial. "Delayed settlement" is a settlement value with the parent still PROCESSING, never a business status.
    - `amount` string
    - `currency` string

## Other responses

- `404`: The resource does not exist, or belongs to another partner.

## Changes

- **2026-11-03** `20fef4fd2ab3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/changes/v1/transactions/:transactionId/legs/get.md)

---

[API](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation.md) - [All operations](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/revisions/20fef4fd2ab3?raw)