# Get Settlement

Retrieves detailed information for a specific settlement by its unique identifier.

Response includes:
- Settlement details (amounts, rates, currencies, notes)
- Current status and timestamps
- Source and destination member information

Endpoint: GET /v2/settlements/{settlement-id}
Version: 1.1.0

## Path parameters:

  - `settlement-id` (string, required)
    Unique settlement identifier (UUID format).

## Response 200 fields (application/json):

  - `settlementId` (string)
    Unique settlement identifier.

  - `settlementStatus` (string)
    Current status of the settlement in the processing lifecycle.

Status Flow:
1. S100_SCHEDULED - Settlement scheduled for future execution
2. S200_RECEIVED - Settlement received and validated, ready for processing
3. S300_IN_PROGRESS - Settlement actively being processed
4. S400_FIAT_WITHDRAWAL_IN_PROGRESS - Final fiat currency withdrawal in progress

Terminal States:

5. S500_TERMINATED - Settlement cancelled or terminated
6. S600_COMPLETED - Settlement successfully completed
7. S700_FAILED - Settlement failed during processing
    Enum: "S100_SCHEDULED", "S200_RECEIVED", "S300_IN_PROGRESS", "S400_FIAT_WITHDRAWAL_IN_PROGRESS", "S500_TERMINATED", "S600_COMPLETED", "S700_FAILED"

  - `settlementAmt` (number)
    Original settlement amount in source currency.

  - `pendingAmt` (number)
    Amount still pending processing in source currency.

  - `rate` (number)
    Exchange rate applied to this settlement. This rate was locked when the settlement was created.

  - `settlementAmtReceived` (number)
    Actual amount received in destination currency. Populated when settlement is completed (S600_COMPLETED status).

  - `sourceCcy` (string)
    Source currency code (ISO 4217 3-letter format).

  - `destinationCcy` (string)
    Destination currency code (ISO 4217 3-letter format).

  - `sourceMemberId` (string)
    Source member identifier.

  - `destinationMemberId` (string)
    Destination member identifier.

  - `notes` (string)
    Notes or description provided when creating the settlement.

  - `creationTime` (string)
    Timestamp when the settlement was created (ISO 8601 format).

  - `completionTime` (string)
    Timestamp when the settlement was completed (ISO 8601 format).

  - `dueDate` (string)
    Expected completion date/time for this settlement. Based on execution interval and processing time estimates.

## Response 400 fields (application/json):

  - `code` (string)

  - `message` (string)

  - `detail` (string)

## Response 404 fields (application/json):

  - `code` (string)

  - `message` (string)

  - `detail` (string)