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

# List settlement accounts

> Returns the merchant's settlement accounts: its own bank accounts that SHOPPING checkouts pay into, newest first. Full bank details are never returned.



## OpenAPI

````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/settlement-accounts
openapi: 3.1.0
info:
  title: Roqqett API
  version: 2.0.0
  description: Version 2
  license:
    name: UNLICENSED
    url: https://docs.equalsmoney.com
servers:
  - url: https://api.equalsmoney.com/v2
    description: Production
security: []
paths:
  /roqqett/settlement-accounts:
    get:
      tags:
        - Settlement Accounts
      summary: List settlement accounts
      description: >-
        Returns the merchant's settlement accounts: its own bank accounts that
        SHOPPING checkouts pay into, newest first. Full bank details are never
        returned.
      operationId: findAllSettlementAccounts
      parameters:
        - name: limit
          in: query
          schema:
            description: The maximum number of results to return.
            default: 100
            type:
              - integer
            minimum: 1
            maximum: 1000
            example: 200
        - name: offset
          in: query
          schema:
            description: The number of items to skip before returning results.
            default: 0
            type:
              - integer
            minimum: 0
            example: 100
        - name: accountId
          in: query
          schema:
            description: The ID of the account to work with.
            type:
              - string
            example: F50091
          required: true
        - name: currencyCode
          in: query
          schema:
            type:
              - string
            enum:
              - GBP
              - EUR
            description: >-
              ISO-4217 code of a currency Roqqett can take payments in: GBP over
              Faster Payments, EUR over SEPA Instant.
            example: GBP
        - name: approvalStatus
          in: query
          schema:
            description: >-
              Only an APPROVED account can receive funds or be set on a
              checkout. A new account is APPROVED automatically only when Equals
              has given the merchant the top-up permission
              (`canCreateTopUpCheckouts`) or the account is an Equals account;
              otherwise it stays PENDING until Equals approves or rejects it.
              Merchants cannot set it.
            type:
              - string
            enum:
              - PENDING
              - APPROVED
              - REJECTED
            example: APPROVED
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  limit:
                    description: The maximum number of results to return.
                    default: 100
                    type:
                      - integer
                    minimum: 1
                    maximum: 1000
                    example: 200
                  offset:
                    description: The number of items to skip before returning results.
                    default: 0
                    type:
                      - integer
                    minimum: 0
                    example: 100
                  count:
                    type:
                      - integer
                    description: >-
                      The total amount of records matching the querying when
                      "limit" is ignored.
                    example: 67
                  rows:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        id:
                          type:
                            - string
                          format: uuid
                          maxLength: 36
                          description: >-
                            The ID of a settlement account: one of the
                            merchant's own bank accounts that SHOPPING checkouts
                            pay into.
                          example: 5c8e2a1f-9d4b-4f7a-8e3c-1b6d0f2a9e64
                        name:
                          type:
                            - string
                            - 'null'
                          minLength: 1
                          maxLength: 18
                          description: >-
                            The merchant's name for the account. `null` when
                            none was stored.
                          example: Main account
                        currencyCode:
                          type:
                            - string
                          enum:
                            - GBP
                            - EUR
                          description: >-
                            ISO-4217 code of a currency Roqqett can take
                            payments in: GBP over Faster Payments, EUR over SEPA
                            Instant.
                          example: GBP
                        bankDetails:
                          discriminator:
                            propertyName: type
                          oneOf:
                            - type:
                                - object
                              properties:
                                type:
                                  type:
                                    - string
                                  enum:
                                    - SORT_CODE
                                sortCode:
                                  type:
                                    - string
                                  maxLength: 6
                                  description: UK sort code.
                                  example: '040004'
                                accountNumberLastFour:
                                  type:
                                    - string
                                  minLength: 4
                                  maxLength: 4
                                  description: Last four digits of the account number.
                                  example: '5678'
                              required:
                                - type
                                - sortCode
                                - accountNumberLastFour
                            - type:
                                - object
                              properties:
                                type:
                                  type:
                                    - string
                                  enum:
                                    - IBAN
                                ibanLastFour:
                                  type:
                                    - string
                                  minLength: 4
                                  maxLength: 4
                                  description: Last four characters of the IBAN.
                                  example: '3000'
                                bic:
                                  type:
                                    - string
                                  maxLength: 11
                                  description: BIC of the payee's bank.
                                  example: COBADEFFXXX
                              required:
                                - type
                                - ibanLastFour
                                - bic
                        bankId:
                          type:
                            - string
                            - 'null'
                          minLength: 1
                          maxLength: 50
                          description: >-
                            The bank that holds the account, which refunds are
                            paid from. `null` until set; refunds from this
                            account fail until it is.
                          example: 1ffe704d39629a929c8e293880fb449a
                        bankName:
                          type:
                            - string
                            - 'null'
                          maxLength: 140
                          description: Name of the bank that holds the account.
                          example: Example Bank
                        approvalStatus:
                          description: >-
                            Only an APPROVED account can receive funds or be set
                            on a checkout. A new account is APPROVED
                            automatically only when Equals has given the
                            merchant the top-up permission
                            (`canCreateTopUpCheckouts`) or the account is an
                            Equals account; otherwise it stays PENDING until
                            Equals approves or rejects it. Merchants cannot set
                            it.
                          type:
                            - string
                          enum:
                            - PENDING
                            - APPROVED
                            - REJECTED
                          example: APPROVED
                        isDefault:
                          type:
                            - boolean
                          description: >-
                            Whether SHOPPING checkouts with no settlement
                            account of their own pay into this one. The
                            merchant's first account becomes the default.
                        checkoutIds:
                          type:
                            - array
                          items:
                            description: >-
                              The ID of a checkout: the configured payment page
                              a checkout session is taken on.
                            type:
                              - string
                            format: uuid
                            maxLength: 36
                            example: 6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12
                          description: >-
                            Checkouts that pay into this account. An account
                            cannot be deleted while any do.
                        bankConnection:
                          type:
                            - object
                          properties:
                            status:
                              type:
                                - string
                              enum:
                                - NOT_CONNECTED
                                - CONNECTED
                                - EXPIRED
                                - ERROR
                              description: >-
                                NOT_CONNECTED until a connection to an account
                                with the same sort code and account number, or
                                IBAN and BIC, is made. CONNECTED while the bank
                                allows access; EXPIRED once that access has
                                lapsed; ERROR when the bank reports a failure,
                                or any other state. Reconnect an EXPIRED or
                                ERROR account with `POST
                                /settlement-accounts/{settlementAccountId}/ob-connections`.
                              example: CONNECTED
                            expiresAt:
                              type:
                                - string
                                - 'null'
                              format: date-time
                              description: >-
                                When the bank access granted to Roqqett expires.
                                `null` when not connected or the bank set no
                                expiry.
                              example: '2027-01-02T12:00:00Z'
                          required:
                            - status
                            - expiresAt
                          description: >-
                            The open banking connection that lets Roqqett read
                            this account's transactions for reconciliation.
                        createdAt:
                          type:
                            - string
                          format: date-time
                          description: >-
                            The date the Resource was initially created. ISO
                            8601 format without milliseconds.
                        updatedAt:
                          type:
                            - string
                          format: date-time
                          description: >-
                            The date the Resource was last modified. ISO 8601
                            format without milliseconds.
                      required:
                        - id
                        - name
                        - currencyCode
                        - bankDetails
                        - bankId
                        - bankName
                        - approvalStatus
                        - isDefault
                        - checkoutIds
                        - bankConnection
                        - createdAt
                        - updatedAt
                required:
                  - count
                  - rows
                example:
                  limit: 200
                  offset: 100
                  count: 67
                  rows:
                    - id: 5c8e2a1f-9d4b-4f7a-8e3c-1b6d0f2a9e64
                      name: Main account
                      currencyCode: GBP
                      bankDetails:
                        type: SORT_CODE
                        sortCode: '040004'
                        accountNumberLastFour: '5678'
                      bankId: 1ffe704d39629a929c8e293880fb449a
                      bankName: Example Bank
                      approvalStatus: APPROVED
                      isDefault: true
                      checkoutIds:
                        - 6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12
                      bankConnection:
                        status: CONNECTED
                        expiresAt: '2027-01-02T12:00:00Z'
                      createdAt: '2019-08-24T14:15:22Z'
                      updatedAt: '2019-08-24T14:15:22Z'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
      security:
        - CommonAuth:
            - roqqett:settlement-accounts:read:any
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.equalsmoney.com/v2/roqqett/settlement-accounts?accountId={{accountId}}' \
              --header 'Authorization: <api-key>'
components:
  securitySchemes:
    CommonAuth:
      type: apiKey
      in: header
      name: Authorization

````