> ## 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 payments > Returns the account's payments and refunds, newest first unless `sort` says otherwise. ## OpenAPI ````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/payments 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/payments: get: tags: - Payments summary: List payments description: >- Returns the account's payments and refunds, newest first unless `sort` says otherwise. operationId: findAllPayments 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: type in: query schema: description: PAYMENT moves money from the payer; REFUND moves it back. type: - string enum: - PAYMENT - REFUND example: PAYMENT - name: checkoutType in: query schema: description: >- SHOPPING pays for a basket into the merchant's settlement account. TOP_UP pays into a payee the merchant supplies. type: - string enum: - SHOPPING - TOP_UP example: SHOPPING - name: status in: query schema: description: PENDING from initiation until the bank confirms the outcome. type: - string enum: - PENDING - COMPLETED - FAILED - CANCELLED example: COMPLETED - name: checkoutSessionId in: query schema: type: - string format: uuid maxLength: 36 description: 'The ID of a checkout session: one payment journey.' example: 0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93 - name: merchantReference in: query schema: description: >- The merchant's own reference for this checkout session, such as its order or basket ID. Shown to the merchant, never to the payer's bank. type: - string minLength: 1 maxLength: 128 example: ORDER-10421 - name: refundedPaymentId in: query schema: description: Only the refunds of this payment. type: - string format: uuid maxLength: 36 example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34 - name: sort in: query schema: description: 'Order by `createdAt`: `desc` is newest first.' default: desc type: - string enum: - asc - desc 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 Roqqett payment or refund record. example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34 type: description: >- PAYMENT moves money from the payer; REFUND moves it back. type: - string enum: - PAYMENT - REFUND example: PAYMENT status: description: >- PENDING from initiation until the bank confirms the outcome. type: - string enum: - PENDING - COMPLETED - FAILED - CANCELLED example: COMPLETED amount: type: - object properties: amount: type: - string maxLength: 32 pattern: ^[0-9]+(\.[0-9]+)?$ description: >- Decimal amount in major units, as a string. Never a float. example: '10000.00' 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 required: - amount - currencyCode description: >- A money value: a decimal amount as a string plus an ISO-4217 currency code. checkoutType: type: - string - 'null' enum: - SHOPPING - TOP_UP description: >- Whether the money was taken by a SHOPPING or a TOP_UP checkout session. A REFUND takes the type of the payment it refunds. `null` when the record has no checkout session. example: SHOPPING checkoutSessionId: type: - string - 'null' format: uuid maxLength: 36 description: 'The ID of a checkout session: one payment journey.' example: 0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93 refundedPaymentId: type: - string - 'null' format: uuid maxLength: 36 description: >- The payment a REFUND returns money from. Always `null` for a PAYMENT. example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34 refundId: type: - string - 'null' format: uuid maxLength: 36 description: >- The ID of the refund a REFUND record belongs to, for `GET /v2/roqqett/refunds/{refundId}`. Always `null` for a PAYMENT. example: 4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45 orderId: type: - string - 'null' format: uuid maxLength: 36 description: >- The ID of an order: the record of a completed shopping checkout session. example: 7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78 merchantReference: type: - string - 'null' minLength: 1 maxLength: 128 description: >- The merchant's own reference for this checkout session, such as its order or basket ID. Shown to the merchant, never to the payer's bank. example: ORDER-10421 payer: type: - object properties: bankName: type: - string - 'null' maxLength: 140 description: Name of the payer's bank. example: Example Bank required: - bankName isRefundable: type: - boolean description: >- Whether a refund can still be created for this payment. initiatedAt: type: - string format: date-time description: When the payer authorised the payment. example: '2026-10-02T12:00:00Z' completedAt: type: - string - 'null' format: date-time description: When the payment reached a terminal status. example: '2026-10-02T12:00:05Z' createdAt: type: - string format: date-time description: >- The date the Resource was initially created. ISO 8601 format without milliseconds. required: - id - type - status - amount - checkoutType - checkoutSessionId - refundedPaymentId - refundId - orderId - merchantReference - payer - isRefundable - initiatedAt - completedAt - createdAt required: - count - rows example: limit: 200 offset: 100 count: 67 rows: - id: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34 type: PAYMENT status: COMPLETED amount: amount: '10000.00' currencyCode: GBP checkoutType: SHOPPING checkoutSessionId: 0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93 refundedPaymentId: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34 refundId: 4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45 orderId: 7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78 merchantReference: ORDER-10421 payer: bankName: Example Bank isRefundable: true initiatedAt: '2026-10-02T12:00:00Z' completedAt: '2026-10-02T12:00:05Z' createdAt: '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:transactions:read:any x-codeSamples: - lang: Shell label: cURL source: |- curl --request GET \ --url 'https://api.equalsmoney.com/v2/roqqett/payments?accountId={{accountId}}' \ --header 'Authorization: ' components: securitySchemes: CommonAuth: type: apiKey in: header name: Authorization ````