Sample - Stripe API
GET/v1/accounts/{account}/persons

List people associated with an account

Lists people associated with an account's legal entity. Use relationship to filter people and starting_after or ending_before to navigate the results; results are sorted with the most recently created people first. Use limit to control the page size.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

6 parameters
accountstringrequired
The account whose associated people you want to retrieve. Maximum 5000 characters.
ending_beforestringoptional
A cursor identifying an object in the list; use it to retrieve the preceding page.
expandarray<string>optional
Fields to expand in each returned person object. Each value must be no longer than 5000 characters.
limitintegeroptional
The maximum number of people to return. Must be between 1 and 100 and defaults to 10 when omitted.
relationshipobjectoptional
Filters people by relationship to the account's company, including `authorizer`, `director`, `executive`, `legal_guardian`, `owner`, or `representative`.
starting_afterstringoptional
A cursor identifying an object in the list; use it to retrieve the following page.

2 status codes
200Returns a list object containing person records in `data`, a `has_more` pagination flag, the list object type, and the list URL.
dataarray<Person>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
Allowed:list
urlstringrequired
The URL where this list can be accessed.
defaultReturned when the request cannot be processed; the response contains an API error object with an error type and related details.
errorobjectrequired

Error handling

account must identify the account whose people you want to list and must not exceed 5000 characters. limit must be between 1 and 100, and each cursor or expand value must be no longer than 5000 characters.