Skip to content

List incoming payments

After one or more incoming payments have been created on a wallet address, an authorized client can look up active and pending incoming payments on that wallet address.

These code snippets retrieve the first ten incoming payments on the given wallet address.

Before you begin

We recommend creating a wallet account on Rafiki.Money, a test wallet provider that’s part of the Interledger testnet. Creating an account allows you to test your client against the Open Payments API using an ILP-enabled wallet funded with play money.

List all incoming payments on a payment pointer

Additional configuration

Add "type": "module" to package.json

Add the following to tsconfig.json

"compilerOptions": {
"target": "ES2022",
"module": "ES2022"

Get started

Import dependencies

import { createAuthenticatedClient } from "@interledger/open-payments";

Initialize Open Payments client

const client = await createAuthenticatedClient({
  walletAddressUrl: WALLET_ADDRESS,
  privateKey: PRIVATE_KEY_PATH,
  keyId: KEY_ID,

List incoming payments

const incomingPayments = await client.incomingPayment.list(
    url: new URL(WALLET_ADDRESS).origin,
    walletAddress: WALLET_ADDRESS,
    first: 10,
    last: undefined,
    cursor: undefined,


console.log("INCOMING PAYMENTS:", JSON.stringify(incomingPayments, null, 2));

Run tsx path/to/directory/index.ts.

View full source