---
updatedAt: 2026-04-21T12:52:44.000Z
agentTools:
  projectIndex: https://developer.lemon.markets/llms.txt
---

# List Settlement Accounts

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "lemon.markets Brokerage API 🍋",
    "version": "0.1.0"
  },
  "x-readme": {
    "proxy-enabled": false,
    "samples-languages": [
      "shell",
      "python",
      "go"
    ]
  },
  "servers": [
    {
      "url": "https://sandbox.api.lemon.markets/v1",
      "description": "Sandbox"
    }
  ],
  "tags": [
    {
      "name": "Cash Settlement"
    }
  ],
  "paths": {
    "/settlement_accounts": {
      "get": {
        "summary": "List Settlement Accounts",
        "operationId": "list_settlement_accounts",
        "tags": [
          "Cash Settlement"
        ],
        "parameters": [
          {
            "name": "cursor",
            "required": false,
            "schema": {
              "title": "Cursor",
              "type": "string"
            },
            "description": "A pagination cursor.  When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.\nA cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.\n",
            "in": "query"
          },
          {
            "name": "limit",
            "required": false,
            "description": "In order to customize the number of elements returned, you can provide a limit here.  The service will not return more elements than specified.\n",
            "schema": {
              "title": "Limit",
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "default": 100
            },
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EncodedPaginatedCollectionResponse_SettlementAccountResponse_"
                },
                "example": {
                  "data": [
                    {
                      "balance": "-60963.74",
                      "currency": "EUR",
                      "id": "psa_5d97d141935e4176aab4233a9311fdd2",
                      "inpayment_bank_account": {
                        "bic": "DEUTDEFFVAC",
                        "iban": "DE58120700700000000006",
                        "name": "Deutsche Bank"
                      },
                      "name": "Default",
                      "withdrawals_in_progress": "0.00"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unprocessable Entity"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server Error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BankAccountResponse": {
        "title": "BankAccountResponse",
        "description": "An object representing a bank account.\n",
        "required": [
          "iban",
          "bic"
        ],
        "type": "object",
        "properties": {
          "iban": {
            "title": "IBAN",
            "type": "string",
            "description": "An IBAN (International Bank Account Number) according to ISO 13616-1:2020.\n"
          },
          "bic": {
            "title": "BIC",
            "type": "string",
            "description": "A BIC (Business Identifier Code) according to ISO 9362.\n"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "description": "The name of the bank managing the bank account.\n"
          }
        }
      },
      "EncodedPaginatedCollectionResponse_SettlementAccountResponse_": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/SettlementAccountResponse"
            },
            "type": "array",
            "title": "Data",
            "description": "The elements of the response.\n"
          },
          "pagination": {
            "$ref": "#/components/schemas/Pagination"
          }
        },
        "type": "object",
        "required": [
          "data",
          "pagination"
        ],
        "title": "Page[SettlementAccountResponse]"
      },
      "ErrorResponse": {
        "title": "ErrorResponse",
        "required": [
          "message"
        ],
        "type": "object",
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          }
        }
      },
      "Pagination": {
        "title": "Pagination",
        "type": "object",
        "properties": {
          "next_cursor": {
            "title": "Cursor for Next Page",
            "type": "string",
            "description": "When fetching long lists of elements, you can use our pagination feature to fetch batches of data.  If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.\n"
          }
        },
        "description": "Information about accessing elements beyond the ones that were returned.\n",
        "example": {
          "next_cursor": "<opaque-data>"
        }
      },
      "SettlementAccountResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Identifier",
            "description": "A string representing the unique identifier of this settlement account.\n",
            "example": "psa_2323"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "description": "Logical name for the bank account, e.g. “Funds Trading” or “Brokerage Pooling”.\n",
            "example": "Funds Trading"
          },
          "inpayment_bank_account": {
            "$ref": "#/components/schemas/BankAccountResponse"
          },
          "currency": {
            "type": "string",
            "title": "Currency",
            "example": "EUR",
            "description": "An ISO 4217 three-letter currency code. Its value represents the currency for the amount and fee listed here. The only currently available currency is `\"EUR\"`.\n"
          },
          "balance": {
            "type": "string",
            "title": "Balance",
            "example": "123.45",
            "description": "Current account balance, excluding `withdrawals_in_progress`.  A positive amount is caused by funds to be paid out to customers, a negative amount would be caused by funds pending transfer to the lemon.markets pooling account.\n"
          },
          "withdrawals_in_progress": {
            "type": "string",
            "title": "Withdrawals In Progress",
            "example": "12.34",
            "description": "Withdrawals in progress to be paid out to the partner. Already deducted from `balance`.\n"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "inpayment_bank_account",
          "currency",
          "balance",
          "withdrawals_in_progress"
        ],
        "title": "SettlementAccountResponse"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```