> ## 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 payees > Returns the account's payees, newest first. ## OpenAPI ````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/payees 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/payees: get: tags: - Payees summary: List payees description: Returns the account's payees, newest first. operationId: findAllPayees 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: startDate in: query schema: description: Only records created on or after this date. type: - string example: '2026-09-01' - name: endDate in: query schema: description: Only records created on or before this date. type: - string example: '2026-09-30' - name: approvalStatus in: query schema: description: >- Only an APPROVED payee can be paid. A new payee is APPROVED automatically only when Equals has given the merchant the top-up permission (`canCreateTopUpCheckouts`) or the payee 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 payee: the bank account a top-up checkout session pays into. example: d2a7c9e1-5b3f-4a8d-9e6c-1f0b2a4c8e57 name: type: - string maxLength: 140 description: Account holder name. example: Example Holdings Ltd 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 approvalStatus: description: >- Only an APPROVED payee can be paid. A new payee is APPROVED automatically only when Equals has given the merchant the top-up permission (`canCreateTopUpCheckouts`) or the payee 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 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 - approvalStatus - createdAt - updatedAt required: - count - rows example: limit: 200 offset: 100 count: 67 rows: - id: d2a7c9e1-5b3f-4a8d-9e6c-1f0b2a4c8e57 name: Example Holdings Ltd currencyCode: GBP bankDetails: type: SORT_CODE sortCode: '040004' accountNumberLastFour: '5678' approvalStatus: APPROVED 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:payees:read:any x-codeSamples: - lang: Shell label: cURL source: |- curl --request GET \ --url 'https://api.equalsmoney.com/v2/roqqett/payees?accountId={{accountId}}' \ --header 'Authorization: ' components: securitySchemes: CommonAuth: type: apiKey in: header name: Authorization ````