# List settlements

Endpoint: GET /v1/settlements
Version: 2.0.0
Security: oAuth2

## Query parameters:

  - `from` (string)

  - `to` (string)

  - `status` (string)
    Enum: "pending", "processing", "completed", "failed"

  - `currency` (string)

  - `limit` (integer)

  - `cursor` (string)

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.settlementId` (string, required)
    Example: "stl_01JH..."

  - `items.date` (string, required)

  - `items.currency` (string, required)
    Example: "USD"

  - `items.gross` (number, required)
    Total amount before fees
    Example: 10000

  - `items.fees` (number, required)
    Total fees deducted
    Example: 150

  - `items.net` (number, required)
    Amount settled (gross - fees)
    Example: 9850

  - `items.status` (string, required)
    Enum: "pending", "processing", "completed", "failed"

  - `items.transactionCount` (integer)
    Number of transactions included
    Example: 250

  - `items.bankAccount` (object)

  - `items.bankAccount.last4` (string)
    Example: "1234"

  - `items.bankAccount.bankName` (string)
    Example: "Bank of America"

  - `items.settledAt` (string,null)

  - `items.createdAt` (string)

  - `pagination` (object)

  - `pagination.nextCursor` (string,null)
    Example: "cursor_abc123"

  - `summary` (object)

  - `summary.totalGross` (number)

  - `summary.totalFees` (number)

  - `summary.totalNet` (number)

  - `summary.count` (integer)


## Response 401 fields