Skip to main content
GET
List IPN Messages

Authorizations

Authorization
string
header
required

B2B’s White Label API uses OAuth2. Currently there is only one supported authentication flow:

  • clientCredentials allows you to access your own B2B account (First-Party Integration) and performs transactions against the public API. This oauth2 flow is well suited for this API, as it allows machine-to-machine communication.

Every call to the API has to be authenticated with an OAuth2 Token. In order to request this token, you will need to have sandbox or production API Keys (client id and client secret) that will be needed to generate a credential in order to negotiate an ephemeral access token.

Every request must be accompianed by an Authorization header with a value that follows the following schema: Bearer ACCESS_TOKEN

Query Parameters

date_gte
string<date-time>

Return messages issued on or after this date. ISO 8601 datetime, e.g. 2026-03-01T00:00:00Z.

date_lte
string<date-time>

Return messages issued on or before this date. ISO 8601 datetime, e.g. 2026-03-31T23:59:59Z.

operation_type
enum<string>

Filter by the operation the message is about. Repeat the parameter to ask for several at once, e.g. ?operation_type=DEPOSIT&operation_type=WITHDRAWAL. It is the prefix of the message event_type, except for end user messages, which are filtered as END_USER and delivered as USER.<status>.

Available options:
DEPOSIT,
WITHDRAWAL,
SWAP,
AUTOSWAP,
FIAT_DEPOSIT,
FIAT_WITHDRAWAL,
END_USER,
P2P_LATAM,
P2P_BATCH,
LOAN,
LOAN_TOP_UP,
LOAN_REPAYMENT,
LOAN_LIQUIDATION
status
enum<string>

Filter by delivery status. COMPLETED means your endpoint acknowledged the message; PENDING means it is still being retried.

Available options:
PENDING,
COMPLETED
webhook_id
integer

Filter by the webhook the message was sent to. Useful when your account has more than one configured.

txn_id
string<uuid>

Filter by transaction identifier. Returns every message issued for that transaction.

end_user_id
string

Filter by end user external reference. Returns every message about that user, both the ones notifying the user itself and the ones about their operations.

p2p_batch_id
string<uuid>

Filter by P2P batch identifier.

ordering
enum<string>
default:-id

Sort order. Defaults to newest first.

Available options:
-created_at,
created_at,
-id,
id
limit
integer

Number of messages to return per page.

offset
integer

Index of the first message to return.

Response

200 - application/json

OK

count
integer

Total count of messages matching the filters.

Example:

123

next
string<uri> | null

Indicates next page by URL.

Example:

"https://api.ripio.com/api/v1/ipn/messages/?limit=50&offset=50"

previous
string<uri> | null

Indicates previous page by URL.

results
IPN Message · object[]

Messages as they were delivered to your webhook. The keys of payload depend on the event: see the Webhooks pages for the structure of each one.