List funding recipient owners

Use this method to return a list of owners of a funding recipient. **Note:** If you want to view the details of a specific owner and you have their ownerId, use our [Retrieve Owner](https://docs.payroc.com/api/schema/boarding/owners/retrieve) method. To list the owners of a funding recipient, you need its recipientId. Our gateway returned the recipientId in the response of the [Create Funding Recipient](https://docs.payroc.com/api/schema/funding/funding-recipients/create) method. If you don't have the recipientId, use our [List Funding Recipients](https://docs.payroc.com/api/schema/funding/funding-recipients/list) method to search for the funding recipient. Our gateway returns the following information about each owner in the list: - Name, date of birth, and address. - Contact details, including their email address. - Relationship to the funding recipient. Our gateway also returns the ownerId, which you can use to perform follow-on actions.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

recipientIdintegerRequired
Unique identifier that we assigned to the funding recipient.

Response

Successful request. Returns a list of all owners associated with the funding recipient.
firstNamestring<=50 characters
Owner's first name.
lastNamestring<=50 characters
Owner's last name.
dateOfBirthdate

Owner’s date of birth. The format of this value is YYYY-MM-DD.

addressobject
Object that contains information about the address.
identifierslist of objects
Array of IDs.
contactMethodslist of objects

Array of contactMethod objects.
Note: If you are adding information about an owner, you must provide at least an email address. If you are adding information about a contact, you must provide at least a contact number.

relationshipobject
Object that contains information about the owner's relationship to the business.
ownerIdinteger or null
Unique identifier that we assigned to the owner.
middleNamestring or null<=50 characters
Owner's middle name.

Errors