Returns a list of people associated with the account’s legal entity. The people are returned sorted by creation date, with the most recent people appearing first.
Parameters
- relationshipobject
Filters on the list of people returned based on the person’s relationship to the account’s company.
- relationship.
boolean A filter on the list of people returned based on whether these people are authorizers of the account’s representative.
- relationship.
directorboolean A filter on the list of people returned based on whether these people are directors of the account’s company.
- relationship.
executiveboolean A filter on the list of people returned based on whether these people are executives of the account’s company.
- relationship.
legal_ guardianboolean A filter on the list of people returned based on whether these people are legal guardians of the account’s representative.
- relationship.
ownerboolean A filter on the list of people returned based on whether these people are owners of the account’s company.
- relationship.
representativeboolean A filter on the list of people returned based on whether these people are the representative of the account’s company.
More parameters
- ending_
beforestring A cursor for use in pagination.
ending_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting withbefore obj_
, your subsequent call can includebar ending_
in order to fetch the previous page of the list.before=obj_ bar - limitinteger
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
- starting_
afterstring A cursor for use in pagination.
starting_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending withafter obj_
, your subsequent call can includefoo starting_
in order to fetch the next page of the list.after=obj_ foo
Returns
A dictionary with a data
property that contains an array of up to limit
people, starting after person starting_
. Each entry in the array is a separate person
object. If no more people are available, the resulting array will be empty.
{ "object": "list", "url": "/v1/accounts/acct_1032D82eZvKYlo2C/persons", "has_more": false, "data": [ { "id": "person_1MqjB62eZvKYlo2CaeEJzKVR", "person": "person_1MqjB62eZvKYlo2CaeEJzKVR", "object": "person", "account": "acct_1032D82eZvKYlo2C", "created": 1680035496, "dob": { "day": null, "month": null, "year": null }, "first_name": "Jane", "future_requirements": { "alternatives": [], "currently_due": [], "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "id_number_provided": false, "last_name": "Diaz", "metadata": {}, "relationship": { "director": false, "executive": false, "owner": false, "percent_ownership": null, "representative": false, "title": null }, "requirements": { "alternatives": [], "currently_due": [], "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "ssn_last_4_provided": false, "verification": { "additional_document": { "back": null, "details": null, "details_code": null, "front": null }, "details": null, "details_code": null, "document": { "back": null, "details": null, "details_code": null, "front": null }, "status": "unverified" } } ]}