# Retrieve Settlement (deprecated)

Returns a detailed breakdown of an outbound settlement by account and customer. Filterable by source and destination accounts.

Endpoint: GET /v1/settlements/{settlement_id}
Version: 1.1.2
Security: OAuth2Flow

## Path parameters:

  - `id` (string, required)
    Settlement ID

## Query parameters:

  - `source_account_id` (string)
    Source Account ID to filter settlement on

  - `destination_account_id` (string)
    Destination Account ID to filter settlement on

## Header parameters:

  - `Authorization` (string)
    OAuth bearer token (see authentication flows)

  - `x-l2f-request-id` (string)
    Optional Unique ID per request, useful for fault resolution/diagnosis and audit.

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.id` (string)
    Settlement ID

  - `data.settlement_status` (string)
    Status of this settlement. Processed settlements are complete and funds dispersed
    Enum: "INITIALIZED", "DELIVERING", "CONVERTING", "SETTLED"

  - `data.settlement_executed_timestamp` (string)
    Time when this settlement was executed (when funds were dispersed)

  - `data.settlement_asset_type` (string)
    Asset type of the settlement
    Enum: "FIAT", "BITCOIN", "ETHEREUM", "POLYGON"

  - `data.settlement_currency` (string)
    Currency of the settlement

  - `data.settlement_amount` (number)
    Full amount of the settlement that was performed (prior to any fee deductions by the receiving institution)

  - `data.settlement_details` (array)
    Breakdown of the transactions that were included in this settlement

  - `data.settlement_details.source_account_customer_id` (string)
    Customer ID of the source account holder

  - `data.settlement_details.source_account_id` (string)
    Source account from which exchange funds were withdrawn

  - `data.settlement_details.source_asset_type` (string)
    Source account asset type
    Enum: "FIAT", "BITCOIN", "ETHEREUM", "POLYGON"

  - `data.settlement_details.source_currency` (string)
    Source account currency

  - `data.settlement_details.source_amount` (number)
    Source account amount withdrawn

  - `data.settlement_details.destination_account_customer_id` (string)
    Customer ID of the destination account holder

  - `data.settlement_details.destination_account_id` (string)
    Destination account into which exchange funds are deposited

  - `data.settlement_details.destination_asset_type` (string)
    Destination account asset type
    Enum: "FIAT", "BITCOIN", "ETHEREUM", "POLYGON"

  - `data.settlement_details.destination_currency` (string)
    Destination account currency

  - `data.settlement_details.destination_amount` (number)
    Destination account amount deposited

  - `data.settlement_details.payment_payor_id` (string)
    Optional Payor ID who performed the initial deposit (only on payment accounts)

  - `data.settlement_details.payment_reference_id` (string)
    Optional Payment Reference ID associated to the initial deposit (only on payment accounts)

  - `data.settlement_details.payment_expected_amount` (string)
    Optional expected amount for this payment (only on payment accounts)

## Response 400 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 401 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 404 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 500 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description