Account Owner 

Describes an owner of an account.

The Account Owner object 

Attributes

  • idstring

    Unique identifier for the object.

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

  • emailnullable string

    The email address of the owner.

  • namestring

    The full name of the owner.

  • ownershipstring

    The ownership object that this owner belongs to.

  • phonenullable string

    The raw phone number of the owner.

  • raw_addressnullable string

    The raw physical address of the owner.

  • refreshed_atnullable timestamp

    The timestamp of the refresh that updated this owner.

The Account Owner object
{
"id": "fcaown_1NtI9uBHO5VeT9SUKLJU5suZ",
"object": "financial_connections.account_owner",
"email": "nobody+janesmith@stripe.com",
"name": "Jane Smith",
"ownership": "fcaowns_1NtI9uBHO5VeT9SUSRe21lqt",
"phone": "+1 555-555-5555",
"raw_address": "123 Main Street, Everytown USA",
"refreshed_at": null
}

The Account Ownership object 

Attributes

  • idstring

    Unique identifier for the object.

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

  • createdtimestamp

    Time at which the object was created. Measured in seconds since the Unix epoch.

  • ownersobject

    A paginated list of owners for this account.

The Account Ownership object
{
"id": "fcaowns_1MwVKR2eZvKYlo2CGV7Mmt6s",
"object": "linked_account_ownership",
"created": 1681412227,
"owners": {
"object": "list",
"data": [],
"has_more": false,
"url": "/v1/linked_accounts/fca_1MwVKR2eZvKYlo2CoMV2L3PV/owners?ownership=fcaowns_1MwVKR2eZvKYlo2CGV7Mmt6s"
}
}

List Account Owners 

Lists all owners for a given Account

Parameters

  • ownershipstringRequired

    The ID of the ownership object to fetch owners from.

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit owners for a given account, starting after owner starting_after. Each entry in the array is a separate owner object. If no more owners are available, the resulting array will be empty.

GET /v1/financial_connections/accounts/:id/owners
curl -G https://api.stripe.com/v1/financial_connections/accounts/fca_1NoEbE2eZvKYlo2CmmnAn2A1/owners \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d ownership=fcaowns_1NoEbE2eZvKYlo2C4Xj7vilA
Response
{
"object": "list",
"url": "/v1/financial_connections/accounts/fca_1NoEbE2eZvKYlo2CmmnAn2A1/owners",
"has_more": false,
"data": [
{
"object": "list",
"url": "/v1/financial_connections/accounts/fca_1NoDzC2eZvKYlo2CwXpqO27d/owners",
"has_more": false,
"data": [
{
"id": "fcaown_1NoDzC2eZvKYlo2C1TlEZ0K2",
"object": "linked_account_owner",
"email": "nobody+janesmith@stripe.com",
"name": "Jane Smith",
"ownership": "fcaowns_1NoDzC2eZvKYlo2CAm1EDKTk",
"phone": "+1 555-555-5555",
"raw_address": "123 Main Street, Everytown USA",
"refreshed_at": null
}
]
}
]
}

Session 

A Financial Connections Session is the secure way to programmatically launch the client-side Stripe.js modal that lets your users link their accounts.