> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mansa.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# List Settlement Facilities

> Retrieve a paginated list of settlement facilities.



## OpenAPI

````yaml openapi-v2-0-0.json get /api/v2/liquidity/management/settlement-facilities
openapi: 3.0.3
info:
  title: Mansa Liquidity API — v2
  description: >
    API for managing credit limits and whitelisted wallets for cross-border
    liquidity operations.


    ## Rate Limiting

    - 100 requests per minute per API key

    - Specific endpoints may have additional limits


    ## Security

    - All endpoints require authentication

    - KYC verification may be required depending on organization policy


    ## Error Handling

    This API uses HTTP status codes and a structured error envelope in the
    response body.


    - **2xx** — The request succeeded.

    - **4xx** — The request failed due to a problem with the information
    provided.

    - **5xx** — A problem occurred on our servers or with an upstream
    dependency.


    When an error occurs, the response body has the shape:


    ```json

    {
      "error": {
        "type": "validation_error",
        "code": "missing_required_field",
        "message": "The 'amount' field is required.",
        "param": "amount",
        "doc_url": "https://docs.mansa.io/errors/missing_required_field",
        "request_id": "req_123456789"
      }
    }

    ```
  version: v2
  contact:
    name: Mansa API Support
    email: api-support@mansa.io
    url: https://docs.mansa.io
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://api.mansa.xyz
    description: Production server
  - url: https://sandbox-api.mansa.xyz
    description: Sandbox server
security:
  - ApiKeyAuth: []
    BearerAuth: []
tags:
  - name: Onboarding
    description: V2 credit limit and whitelist operations
  - name: Management
    description: V2 settlement facilities, balances, withdrawal requests, and repayments
  - name: Utilization
    description: >-
      V2 drawdown intents, settlement confirmations, proofs, and document
      uploads
paths:
  /api/v2/liquidity/management/settlement-facilities:
    get:
      tags:
        - Management
      summary: List Settlement Facilities
      description: Retrieve a paginated list of settlement facilities.
      operationId: listSettlementFacilities
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 10
            minimum: 1
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: status
          in: query
          required: false
          schema:
            type: string
        - name: chain_id
          in: query
          required: false
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: List of settlement facilities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettlementFacilityListResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    SettlementFacilityListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SettlementFacility'
        meta:
          $ref: '#/components/schemas/Meta'
    SettlementFacility:
      type: object
      properties:
        id:
          type: string
          format: uuid
        amount:
          type: string
        chain_id:
          type: string
          format: uuid
        status:
          type: string
          example: ACTIVE
        settlement_date:
          type: string
          format: date-time
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    Meta:
      type: object
      properties:
        limit:
          type: integer
          example: 50
        page:
          type: integer
          example: 1
        total:
          type: integer
          example: 1
    ErrorResponse:
      type: object
      description: Standard error envelope
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
      required:
        - error
      additionalProperties: false
      example:
        error:
          type: validation_error
          code: missing_required_field
          message: The 'amount' field is required.
          param: amount
          doc_url: https://docs.mansa.io/errors/missing_required_field
          request_id: req_123456789
    ErrorObject:
      type: object
      properties:
        type:
          allOf:
            - $ref: '#/components/schemas/ErrorTypeEnum'
        code:
          type: string
          nullable: true
          description: Programmatic error code
        message:
          type: string
          nullable: true
          description: Human-readable error message
        param:
          type: string
          nullable: true
          description: Parameter related to the error, if applicable
        doc_url:
          type: string
          format: uri
          nullable: true
          description: Link to docs for this error
        request_id:
          type: string
          nullable: true
          description: Internal request identifier for support
      required:
        - type
      additionalProperties: false
    ErrorTypeEnum:
      type: string
      enum:
        - api_error
        - validation_error
        - auth_error
        - idempotency_error
        - rate_limit_error
  responses:
    Unauthorized:
      description: Authentication required or invalid credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            invalid_token:
              value:
                error:
                  type: auth_error
                  code: invalid_token
                  message: Bearer token is missing or invalid.
    RateLimited:
      description: Rate limit exceeded
      headers:
        X-RateLimit-Limit:
          description: Request limit per window
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Remaining requests in window
          schema:
            type: integer
        X-RateLimit-Reset:
          description: UNIX epoch seconds when the rate limit resets
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            too_many_requests:
              value:
                error:
                  type: rate_limit_error
                  code: too_many_requests
                  message: Too many requests. Please retry with exponential backoff.
    ServerError:
      description: Internal server or upstream error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            upstream_failure:
              value:
                error:
                  type: api_error
                  code: upstream_dependency_error
                  message: A dependency failed to process the request.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token following RFC001 specification

````