> ## Documentation Index > Fetch the complete documentation index at: https://docs.rampapay.com/llms.txt > Use this file to discover all available pages before exploring further. # List your payments > **Scope:** `payouts:read` Newest first. Each item is a payment, exactly as `GET /payouts/{id}` returns it. Filter with the query parameters below; page with `limit` and the `next_cursor` of the previous answer, which is `null` on the last page. Useful for reconciliation, and to find a payment by `transaction_id` after a lost response. ## OpenAPI ````yaml api-reference/openapi.json GET /payouts openapi: 3.0.3 info: title: Rampa Pay API version: 1.0.0 description: >- Hold a USDT balance at Rampa and pay Bolivian merchant QRs in bolivianos. Amounts are decimal strings. servers: - url: https://examples.staging.rampapay.com/v1 description: 'Example server: sample answers, nothing real moves' security: - apiKey: [] tags: - name: Accounts description: Every balance you hold with Rampa, in one place. - name: Wallet description: Your USDT balance at Rampa, and how money gets into it. - name: Payouts description: >- Quote a BOB amount in USDT; once your end user accepts, pay it out at that quote from your USDT wallet — to a merchant QR today, to a bank account soon. - name: Webhooks description: Where we send events. Each endpoint gets its own signing secret. paths: /payouts: get: tags: - Payouts summary: List your payments description: >- **Scope:** `payouts:read` Newest first. Each item is a payment, exactly as `GET /payouts/{id}` returns it. Filter with the query parameters below; page with `limit` and the `next_cursor` of the previous answer, which is `null` on the last page. Useful for reconciliation, and to find a payment by `transaction_id` after a lost response. operationId: list-payouts parameters: - name: transaction_id in: query required: false schema: type: string description: '`string`. Only the payout with this transaction id.' - name: type in: query required: false schema: type: string enum: - qr - bank_transfer description: '`qr | bank_transfer`. Only payouts of this type.' - name: status in: query required: false schema: type: string enum: - status description: >- `status`. Only payments that ended so: completed, failed, rejected or cancelled. - name: from in: query required: false schema: type: string format: date-time description: >- `ISO-8601 instant`. Created at or after this instant. Must carry a zone, e.g. 2026-10-01T04:00:00Z. - name: to in: query required: false schema: type: string format: date-time description: >- `ISO-8601 instant`. Created at or before this instant (inclusive). Must carry a zone. - name: limit in: query required: false schema: type: integer description: '`integer 1–100`. Page size. Default 50.' - name: cursor in: query required: false schema: type: string description: '`string`. next_cursor from the previous page. Keep the same filters.' responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string type: type: string status: type: string transaction_id: type: string resolution_id: type: string quote: type: object properties: id: type: string source: type: object properties: currency: type: string amount: type: string target: type: object properties: currency: type: string amount: type: string rate: type: string fee: type: object properties: currency: type: string amount: type: string expires_at: type: string source: type: object properties: currency: type: string amount: type: string target: type: object properties: currency: type: string amount: type: string qr: type: object properties: amount_mode: type: string merchant: type: object properties: name: type: string bank_code: type: string error: nullable: true completed_at: type: string created_at: type: string next_cursor: nullable: true example: data: - id: po_9Fz3Kd7RwP2mX8cT4nB6vQ1h type: qr status: completed transaction_id: W-1001 resolution_id: qrr_8KqT2mWx5ZbN7cJ4hRvP1sLd quote: id: 6f0c2a8e-4b7d-4f1e-9a51-3c2d8e7b9a10 source: currency: USDT amount: '101.500000' target: currency: BOB amount: '1000.00' rate: '9.9500' fee: currency: USDT amount: '1.000000' expires_at: '2026-09-27T14:05:00.000Z' source: currency: USDT amount: '101.500000' target: currency: BOB amount: '1000.00' qr: amount_mode: closed merchant: name: Café del Prado bank_code: '1014' error: null completed_at: '2026-09-27T14:02:12.000Z' created_at: '2026-09-27T14:02:11.000Z' next_cursor: null '400': description: >- A filter is malformed: from or to without a zone, limit outside 1–100, an unknown status, or a cursor we did not return. '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' components: responses: Unauthorized: description: >- `AUTHENTICATION_FAILED` — the key is missing, unknown, revoked or expired, or the tenant is suspended. Forbidden: description: '`SCOPE_REQUIRED` — your key lacks this endpoint''s scope. Ask Rampa.' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: >- On the example server, any key that starts with `rpk_mock_`, e.g. `rpk_mock_yourname`. Never your real key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.