> ## Documentation Index > Fetch the complete documentation index at: https://developer.paywint.com/llms.txt > Use this file to discover all available pages before exploring further. # List Paywint Bank Account Transactions > Retrieves a paginated list of Paywint bank transactions for a specific user. This endpoint allows platforms to: - View transaction history associated with a user’s Paywint bank account - Filter and paginate transactions by account and user - Access transaction details such as amount, type, and date When this endpoint is called for the first time, the system automatically initiates a background sync to fetch the latest Paywint transactions. During this initial sync (which may take up to **one minute**), the response will contain only previously available transactions. To view newly synced transactions, call this endpoint again after **one minute**. Returns the total number of transactions and a list of transaction records. ## OpenAPI ````yaml POST /api/platform/accounts/list-pw-transactions/{user_id} openapi: 3.1.0 info: title: paywint version: 0.1.0 servers: - url: http://localhost:8001 - url: https://api.pw.wintpay.com - url: https://test.pw.wintpay.com - url: https://api.sandbox.paywint.com security: [] paths: /api/platform/accounts/list-pw-transactions/{user_id}: post: tags: - Platform Accounts summary: List Paywint Bank Transactions description: >- Retrieves a paginated list of Paywint bank transactions for a specific user. This endpoint allows platforms to: - View transaction history associated with a user’s Paywint bank account - Filter and paginate transactions by account and user - Access transaction details such as amount, type, and date When this endpoint is called for the first time, the system automatically initiates a background sync to fetch the latest Paywint transactions. During this initial sync (which may take up to **one minute**), the response will contain only previously available transactions. To view newly synced transactions, call this endpoint again after **one minute**. Returns the total number of transactions and a list of transaction records. operationId: >- list_pw_bank_transactions_api_platform_accounts_list_pw_transactions__user_id__post parameters: - name: user_id in: path required: true schema: type: string format: uuid description: Unique identifier (UUID) of the user title: User Id description: Unique identifier (UUID) of the user example: f47ac10b-****-****-****-0e02b2c3d479 - name: X-Platform-ID in: header required: true schema: type: string format: uuid description: >- Unique platform identifier (UUID). You receive this during onboarding. Must be sent with every API request. title: X-Platform-Id description: >- Unique platform identifier (UUID). You receive this during onboarding. Must be sent with every API request. - name: X-Signature in: header required: true schema: type: string description: >- HMAC-SHA256 request signature for authentication. Use your platform secret key to compute it as: `METHOD + PATH + QUERY + BODY_HASH`. title: X-Signature description: >- HMAC-SHA256 request signature for authentication. Use your platform secret key to compute it as: `METHOD + PATH + QUERY + BODY_HASH`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PlatformPaywintBankPaginatedRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/ExternalListResponse_ExternalAccountTransactionsRead_ '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: PlatformPaywintBankPaginatedRequest: properties: rows_per_page: $ref: '#/components/schemas/RowsPerPage' description: >- Number of records to return per page. Accepted values are 10, 20, 50, or 100. example: 50 page_no: type: integer minimum: 1 title: Page No description: >- Page number to retrieve, starting from 1. For example, page_no=1 returns the first page of results. example: 1 account_id: type: string format: uuid title: Account Id description: >- Unique identifier (UUID) of the user's Paywint bank account for which transactions are being retrieved. example: f47ac10b-****-****-****-0e02b2c3d479 type: object required: - rows_per_page - page_no - account_id title: PlatformPaywintBankPaginatedRequest ExternalListResponse_ExternalAccountTransactionsRead_: properties: success: type: boolean title: Success description: Indicates whether the request was processed successfully. default: true example: true status_code: anyOf: - type: integer - type: 'null' title: Status Code description: HTTP status code representing the result of the request. default: 200 message: anyOf: - type: string - type: 'null' title: Message description: Short, human-readable message describing the outcome of the request. default: Success records: anyOf: - items: $ref: '#/components/schemas/ExternalAccountTransactionsRead' type: array - type: 'null' title: Records description: List of result items returned for the current page. totalRecords: anyOf: - type: integer - type: 'null' title: Totalrecords description: >- Total number of matching records in the database, useful for paginating the full dataset. default: 0 queryGeneratedTime: anyOf: - type: integer - type: 'null' title: Querygeneratedtime description: >- Unix timestamp (in seconds) indicating when this response was generated. default: 1782303609 type: object title: ExternalListResponse[ExternalAccountTransactionsRead] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError RowsPerPage: type: integer enum: - 10 - 20 - 50 - 100 title: RowsPerPage ExternalAccountTransactionsRead: properties: transaction_id: anyOf: - type: string format: uuid - type: 'null' title: Transaction Id description: Unique identifier (UUID) of the transaction record. example: cb4cbbdf-a2bd-4c41-98f0-7da1d8657898 amount: anyOf: - type: number - type: 'null' title: Amount description: Monetary amount of the transaction in the user’s account currency. example: 100 transaction_date: anyOf: - type: string format: date - type: 'null' title: Transaction Date description: Date when the transaction was processed or recorded. example: '2025-10-06' is_credit: anyOf: - type: boolean - type: 'null' title: Is Credit description: Specifies if the transaction is a credit (True) or debit (False). example: false internal_payment_id: anyOf: - type: string format: uuid - type: 'null' title: Internal Payment Id description: >- Unique identifier (UUID) of the related payment record, if applicable. description: anyOf: - type: string - type: 'null' title: Description description: Text description or note associated with the transaction. example: 'Invoice #1234 payment' payer_payee: anyOf: - type: string - type: 'null' title: Payer Payee description: Name of the payer or payee involved in the transaction. example: Robert is_internal_payment: anyOf: - type: boolean - type: 'null' title: Is Internal Payment description: >- Indicates whether the transaction occurred internally within the Paywint platform. example: true type: object title: ExternalAccountTransactionsRead ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ````