Skip to content

List Recipients

GET
/v2/send/recipients

List recipients with pagination and optional userId filtering

page[number]
number
default: 1

Page number (starts at 1)

Example
1
page[size]
number
default: 10

Items per page

Example
10
userId
required
string format: uuid

Filter by external user ID

Example
82c4fce1-d2c7-48cb-a647-6993dbe37819

Paginated list of recipients

object
items
required

List of recipients

Array<object>
object
id
required

Recipient ID

string format: uuid
82c4fce1-d2c7-48cb-a647-6993dbe37819
organisationId
required

Organisation ID

string format: uuid
userId
required

User ID

string format: uuid
displayNickName
required

Display nickname for recipient

string
John
tokenizationId
required

Tokenization ID from Aegis vault

string
bankDetails
required

Bank details (detokenized)

object
createdAt
required

Created at

string format: date-time
updatedAt
required

Updated at

string format: date-time
page
required

Pagination info

object
number
required

Page number (starts at 1)

number
1
size
required

Items per page

number
10
totalPages
required

Total number of items

number
100
totalCount
required

Total number of pages

number
10
hasNext
required

Whether there is a next page

boolean
true
hasPrev
required

Whether there is a previous page

boolean

Bad Request

Unauthorized

Forbidden

Not Found

Internal Server Error