> ## 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. # Retrieve a settlement account > Returns one settlement account with its approval status. Full bank details are never returned. Returns 404 if it is not on the account. ## OpenAPI ````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/settlement-accounts/{settlementAccountId} 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/{settlementAccountId}: get: tags: - Settlement Accounts summary: Retrieve a settlement account description: >- Returns one settlement account with its approval status. Full bank details are never returned. Returns 404 if it is not on the account. operationId: findOneSettlementAccount parameters: - name: settlementAccountId in: path required: true schema: 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: accountId in: query schema: description: The ID of the account to work with. type: - string example: F50091 required: true responses: '200': description: OK content: application/json: schema: 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 example: 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' '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/{settlementAccountId}?accountId={{accountId}}' \ --header 'Authorization: ' components: securitySchemes: CommonAuth: type: apiKey in: header name: Authorization ````