View recipients

Returns all recipients that meet the specified parameters (if any) and that are associated with the Nexio account used to authenticate.

You may also request to return additional parameters and/or filter results using one or more query parameters.

📘

Notes

For example, to return (filter) all recipients where the address' country is NL and also (request to include) the recipientIdNumbers object in the response, the request would look like this:
/payout/v3/recipient?recipientIdNumbers.&country=NL

To return (filter) only the recipient with the specified recipientRef parameter, the request would look like this:
/payout/v3/recipient?recipientRef=10524260

For a more detailed tutorial, see the query parameters section of Guides.

⚠️

Try It

To use the Try It feature for this endpoint, you must use the credentials for your Sandbox API user.

Request parameters

  • limit
  • offset
  • startDate
  • endDate
  • recipientId
  • recipientRef
  • providerRecipientRef
  • providerType
  • email
  • firstName
  • lastName
  • phoneNumber
  • mobileNumber
  • addressLine1
  • addressLine2
  • city
  • region
  • postalCode
  • country
  • countryOfBirth
  • countryOfNationality
  • providerId
  • payoutAccountId
  • recipientIdNumbers
  • recipientIdNumbers.governmentId
  • recipientIdNumbers.passportId
  • recipientIdNumbers.employerId
  • recipientIdNumbers.driversLicenseId
  • userType
  • birthDate
  • gender
  • addressType
  • phoneNumberCountry
  • mobileNumberCountry
  • governmentIdType
  • createdAt
  • updatedAt

Response parameters

  • offset
  • limit
  • rows
  • rows.recipientRef
  • rows.recipientId
  • rows.payoutAccountId
  • rows.providerId
  • rows.providerType
  • rows.providerRecipientRef
  • rows.userType
  • rows.firstName
  • rows.lastName
  • rows.gender
  • rows.birthDate
  • rows.countryOfBirth
  • rows.countryOfNationality
  • rows.addressLine1
  • rows.addressLine2
  • rows.city
  • rows.region
  • rows.postalCode
  • rows.country
  • rows.email
  • rows.phoneNumber
  • rows.mobileNumber
  • rows.governmentIdType
  • rows.recipientIdNumbers
  • rows.recipientIdNumbers.governmentId
  • rows.recipientIdNumbers.passportId
  • rows.recipientIdNumbers.employerId
  • rows.recipientIdNumbers.driversLicenseId
  • rows.createdAt
  • rows.updatedAt
  • hasMore
Language
Authorization
Basic
base64
:
Click Try It! to start a request and see the response here!