List Paywint Bank Transactions

curl --request POST \
  --url https://api.sandbox.paywint.com/api/platform/accounts/list-pw-transactions/{user_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Platform-ID: <x-platform-id>' \
  --header 'X-Signature: <x-signature>' \
  --data '
{
  "rows_per_page": 50,
  "page_no": 1,
  "account_id": "f47ac10b-****-****-****-0e02b2c3d479"
}
'

{
  "success": true,
  "status_code": 200,
  "message": "Success",
  "records": [
    {
      "transaction_id": "cb4cbbdf-a2bd-4c41-98f0-7da1d8657898",
      "amount": 100,
      "transaction_date": "2025-10-06",
      "is_credit": false,
      "internal_payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "Invoice #1234 payment",
      "payer_payee": "Robert",
      "is_internal_payment": true
    }
  ],
  "totalRecords": 0,
  "queryGeneratedTime": 1763722745
}

Bank Accounts

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.

POST

api

platform

accounts

list-pw-transactions

{user_id}

List Paywint Bank Transactions

curl --request POST \
  --url https://api.sandbox.paywint.com/api/platform/accounts/list-pw-transactions/{user_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Platform-ID: <x-platform-id>' \
  --header 'X-Signature: <x-signature>' \
  --data '
{
  "rows_per_page": 50,
  "page_no": 1,
  "account_id": "f47ac10b-****-****-****-0e02b2c3d479"
}
'

{
  "success": true,
  "status_code": 200,
  "message": "Success",
  "records": [
    {
      "transaction_id": "cb4cbbdf-a2bd-4c41-98f0-7da1d8657898",
      "amount": 100,
      "transaction_date": "2025-10-06",
      "is_credit": false,
      "internal_payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "Invoice #1234 payment",
      "payer_payee": "Robert",
      "is_internal_payment": true
    }
  ],
  "totalRecords": 0,
  "queryGeneratedTime": 1763722745
}

Headers

X-Platform-ID

string<uuid>

required

Unique platform identifier (UUID). You receive this during onboarding. Must be sent with every API request.

X-Signature

string

required

HMAC-SHA256 request signature for authentication. Use your platform secret key to compute it as: METHOD + PATH + QUERY + BODY_HASH.

Path Parameters

user_id

string<uuid>

required

Unique identifier (UUID) of the user

Body

application/json

rows_per_page

enum<integer>

required

Number of records to return per page. Accepted values are 10, 20, 50, or 100.

Available options:

10,

20,

50,

100

Example:

50

page_no

integer

required

Page number to retrieve, starting from 1. For example, page_no=1 returns the first page of results.

Required range: x >= 1

Example:

1

account_id

string<uuid>

required

Unique identifier (UUID) of the user's Paywint bank account for which transactions are being retrieved.

Example:

"f47ac10b-****-****-****-0e02b2c3d479"

Response

Successful Response

success

boolean

default:true

Indicates whether the request was processed successfully.

Example:

true

status_code

integer | null

default:200

HTTP status code representing the result of the request.

message

string | null

default:Success

Short, human-readable message describing the outcome of the request.

records

ExternalAccountTransactionsRead · object[] | null

List of result items returned for the current page.

Show child attributes

records.transaction_id

string<uuid> | null

Unique identifier (UUID) of the transaction record.

Example:

"cb4cbbdf-a2bd-4c41-98f0-7da1d8657898"

records.amount

number | null

Monetary amount of the transaction in the user’s account currency.

Example:

100

records.transaction_date

string<date> | null

Date when the transaction was processed or recorded.

Example:

"2025-10-06"

records.is_credit

boolean | null

Specifies if the transaction is a credit (True) or debit (False).

Example:

false

records.internal_payment_id

string<uuid> | null

Unique identifier (UUID) of the related payment record, if applicable.

records.description

string | null

Text description or note associated with the transaction.

Example:

"Invoice #1234 payment"

records.payer_payee

string | null

Name of the payer or payee involved in the transaction.

Example:

"Robert"

records.is_internal_payment

boolean | null

Indicates whether the transaction occurred internally within the Paywint platform.

Example:

true

totalRecords

integer | null

default:0

Total number of matching records in the database, useful for paginating the full dataset.

queryGeneratedTime

integer | null

default:1763722745

Unix timestamp (in seconds) indicating when this response was generated.

Open Paywint Bank Account Get Bank Account

⌘I

Get Started

Users

KYC

KYB

Payment

Checkout

Bank Accounts

Cards

Wallet

Payee

Payee Bank Accounts

Payee Cards

List Paywint Bank Account Transactions

Headers

Path Parameters

Body

Response