List Stakeholders on an Account

Returns Stakeholders attached to this Account. Use the filters to scope: ?filter[isPrincipal][eq]=true for the Principal (the one Person a business of one is fused with), ?filter[subjectType][eq]=Person for natural-human stakeholders, ?filter[isController][eq]=true for designated controllers, ?filter[ownershipPercentage][gte]=25 for beneficial owners by ownership threshold, and ?filter[status][eq]=Active to leave out removed (Revoked) team members. Use isController for the authorized representative. Combine for the full beneficial-ownership list (Principal/Person owners with 25% or more ownership or controllers; the 25% threshold matches the US default and is jurisdiction-configurable), and add ?filter[status][eq]=Active so removed members are left out.
Principal, beneficial-ownership, and external-id filters are backed by the users service. Unsupported filter operators return 422 ValidationError instead of silently broadening or mis-mapping the query.
pagination.totalSize is the number of Stakeholders matching the filters at the time of the request. It can change between pages and may be absent.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^(?:[A-Za-z0-9_.]{22}|[a-f0-9]{24})$

Account identifier. Newly created V3 Accounts use a 22-character Wingspan ID; migrated Accounts may retain a 24-character lowercase hexadecimal ID.

Query Params
filter
object

Filters use deep-object query parameters, for example filter[status][eq]=Active. For array operators, use filter[field][anyOf][]=value.

page
object

Pagination query parameters. Serializes as page[size] and page[token].

Headers
string
^(?:[A-Za-z0-9_.]{22}|[a-f0-9]{24})$

Select the Account for an Account-scoped operation. A direct ServiceAccount API key MUST supply this header, and the target must be within the ServiceAccount owner's or Authorization grant's Account boundary. A Person bearer may select an Account on which it has an active Stakeholder, and an Account session may select its bound Account (or a descendant only when the session explicitly includes descendants).

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json