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.
More parameters
- ending_
beforestring - limitinteger
- starting_
afterstring
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" } } ]}
Deletes an existing person’s relationship to the account’s legal entity. Any person with a relationship for an account can be deleted through the API, except if the person is the account_
. If your integration is using the executive
parameter, you cannot delete the only verified executive
on file.
Parameters
No parameters.
Returns
Returns the deleted person
object.
{ "id": "person_1MqjB62eZvKYlo2CaeEJzKVR", "object": "person", "deleted": true}
To top up your Stripe balance, you create a top-up object. You can retrieve individual top-ups, as well as list all top-ups. Top-ups are identified by a unique, random ID.
Related guide: Topping up your platform account
A Transfer
object is created when you move funds between Stripe accounts as part of Connect.
Before April 6, 2017, transfers also represented movement of funds from a Stripe account to a card or bank account. This behavior has since been split out into a Payout object, with corresponding payout endpoints. For more information, read about the transfer/payout split.
Related guide: Creating separate charges and transfers
Stripe Connect platforms can reverse transfers made to a connected account, either entirely or partially, and can also specify whether to refund any related application fees. Transfer reversals add to the platform’s balance and subtract from the destination account’s balance.
Reversing a transfer that was made for a destination charge is allowed only up to the amount of the charge. It is possible to reverse a transfer_group transfer only if the destination account has enough balance to cover the reversal.
Related guide: Reverse transfers