Skip to main content
GET
List payment links
Results are returned in the data array with a pagination object. Links are scoped automatically to your API key’s entity level.

Filtering

Cursor pagination

To fetch the next page, pass the next_cursor value from the previous response as the cursor query parameter:
When has_more is false, you have reached the last page.

Required scope

payment_links.read

Authorizations

Authorization
string
header
required

API key passed as a bearer token. Use sk_live_ keys for production and sk_test_ keys for sandbox. Keys are provisioned during merchant onboarding.

Query Parameters

status
enum<string>

Filter by payment link status. Current status of the payment link.

Available options:
ACTIVE,
CONSUMED,
EXPIRED,
CANCELLED
merchant_branch_reference_number
string

Filter by branch reference number. Only applicable for partner- or merchant-level keys.

created_after
string<date-time>

ISO 8601 timestamp. Only return links created after this time.

created_before
string<date-time>

ISO 8601 timestamp. Only return links created before this time.

page_size
integer
default:50

Number of results per page.

Required range: 1 <= x <= 200
cursor
string

Opaque pagination token from a previous response's next_cursor.

Response

A paginated list of payment links

data
object[]
required
pagination
object
required