> ## Documentation Index > Fetch the complete documentation index at: https://docs.lite.sa/llms.txt > Use this file to discover all available pages before exploring further. # List settlement accounts > Retrieves the merchant's settlement accounts, newest first. ## OpenAPI ````yaml /openapi/account-settlement.json get /settlements/settlement-accounts openapi: 3.1.0 info: title: lite - Account Settlement version: 1.0.0 servers: - url: https://api.lite.sa/v1 description: Production security: - ApiKeyAuth: [] - BearerAuth: [] tags: - name: Settlement Windows description: Manage settlement windows for merchant payout cycles - name: Transactions description: Query settlement transactions and their details - name: Settlement description: >- Register verified seller settlement accounts, view acceptance account balances, and pay out on demand from an acceptance account to a settlement account paths: /settlements/settlement-accounts: servers: - url: https://api.lite.sa description: Production get: tags: - Settlement summary: List settlement accounts description: | Retrieves the merchant's settlement accounts, newest first. operationId: lite.settlement.listSettlementAccounts parameters: - $ref: '#/components/parameters/x-correlation-id' - name: page in: query required: false schema: type: integer minimum: 1 default: 1 description: Page number (1-indexed) - name: page_size in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 25 description: Number of items per page - name: status in: query required: false schema: type: string enum: - ACTIVE - DELETED description: Filter by settlement account status responses: '200': $ref: '#/components/responses/SettlementAccountList' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalServerError' security: - ApiKeyAuth: [] components: parameters: x-correlation-id: name: x-correlation-id in: header required: false description: >- Unique identifier for request tracing. Generated by the client or server if not provided. schema: type: string format: uuid example: 550e8400-e29b-41d4-a716-446655440000 responses: SettlementAccountList: description: List of settlement accounts retrieved successfully. content: application/json: schema: type: object required: - data - pagination_data properties: data: type: array description: List of settlement accounts items: $ref: '#/components/schemas/SettlementAccount' pagination_data: $ref: '#/components/schemas/PaginationData' BadRequest: description: > The request was invalid or malformed. Returned when: - Request validation fails (missing required fields, invalid field formats) - Payment details do not match the session (amount, currency, order reference mismatch) - The operation is not allowed given the current resource state content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: | Authentication failed — missing or invalid token. Returned when: - The JWT bearer token is missing, expired, or has an invalid signature - The API key is missing or invalid - The authenticated session token is invalid content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: > Request blocked by security policy. Returned when: - A security threat is detected (SQL injection, XSS, NoSQL injection, LDAP injection, path traversal) - Header injection or suspicious headers are detected - The request payload exceeds the maximum allowed size - Geo-region validation fails (user country does not match client region) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: > An unexpected error occurred on the server. Returned when an unhandled exception or infrastructure failure prevents the request from being processed. Retry the request with exponential backoff. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' schemas: SettlementAccount: type: object description: >- A settlement account (seller bank account) that can receive payouts from an acceptance account required: - id - status - name - masked_national_id - masked_iban - currency - created_at - updated_at properties: id: type: string format: uuid description: Unique settlement account identifier example: 4b0f6c1e-2d3a-4f5b-8c7d-9e0f1a2b3c4d status: type: string description: Settlement account status oneOf: - title: Active const: ACTIVE description: Verified and able to receive payouts - title: Deleted const: DELETED description: Removed by the merchant, can no longer receive payouts name: type: string description: Account holder name as submitted, verified against the bank records example: Mohammed Ali Alharbi masked_national_id: type: string description: Account holder National ID or Iqama number, masked example: 1*******78 masked_iban: type: string description: Account IBAN, masked example: SA03****************7519 currency: type: string description: ISO 4217 currency code example: SAR created_at: type: string format: date-time description: Timestamp when the account was registered example: '2026-09-29T10:00:00.000Z' updated_at: type: string format: date-time description: Timestamp of the last update example: '2026-09-29T10:00:00.000Z' PaginationData: type: object description: Pagination metadata for list responses required: - count - pages - page - page_size - has_next - has_previous properties: count: type: integer description: Total number of items matching the query minimum: 0 example: 100 pages: type: integer description: Total number of pages minimum: 0 example: 4 page: type: integer description: Current page number (1-indexed) minimum: 1 example: 1 page_size: type: integer description: Number of items per page minimum: 1 example: 25 has_next: type: boolean description: Whether there is a next page example: true has_previous: type: boolean description: Whether there is a previous page example: false ErrorResponse: type: object required: - error properties: error: type: object required: - code - message - timestamp properties: code: type: string description: Error code identifying the type of error example: PAYMENT_DETAILS_MISMATCH message: type: string description: Human-readable error description example: The request was invalid or malformed details: type: object description: Additional error details correlationId: type: string format: uuid description: Correlation ID for tracking the request example: 550e8400-e29b-41d4-a716-446655440000 timestamp: type: string format: date-time description: Timestamp when the error occurred example: '2024-12-16T10:30:00.000Z' securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key for service-to-service or merchant authentication. BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token obtained from user authentication. Passed as Authorization: Bearer . ````