Expanding Resources
Many objects allow you to request additional information as an expanded response by using the expand query parameter.
This parameter is available for entities
, accounts
, and Connect
and applies to the response of that request only.
In many cases, an object contains the ID of a related object in its response attributes. For example, an Entity
might have an associated CreditScore
ID.
You can expand these objects in line with the expand query parameter. The expandable label in this documentation indicates ID fields that you can expand into objects.
You can expand multiple objects at the same time by identifying multiple items in the expand array. Performing expansions on list requests might result in increased response times.
In the case of Connect
, recursive expansion up to 2 levels is supported. The first level expands the returned accounts
.
The second level allows expansion of any account-level properties using the notation accounts.expandable_field
, such as accounts.update
.
For more information, see Connect Expand Enum
Props
Attributes that can be expanded into an object to provide additional information.
Possible enum values
Possible enum values
connect
This is an Entity property, and refers to the Connect Object.
credit_score
This is an Entity property, and refers to the CreditScore Object.
attribute
This is an Entity property, and refers to the Attribute Object.
vehicle
This is an Entity property, and refers to the Vehicle Object.
identity_latest_verification_session
This is an Entity property, and refers to the EntityVerificationSession Object.
phone_latest_verification_session
This is an Entity property, and refers to the EntityVerificationSession Object.
sensitive
This is an Account property, and refers to the Sensitive Object.
balance
This is an Account property, and refers to the Balance Object.
card_brand
This is an Account property, and refers to the CardBrand Object.
attribute
This is an Account property, and refers to the Attribute Object.
payoff
This is an Account property, and refers to the Payoff Object.
transaction
This is an Account property, and refers to the Transaction Object.
update
This is an Account property, and refers to the Update Object.
payment_instrument
This is an Account property, and refers to the PaymentInstrument Object.
latest_verification_session
This is an Account property, and refers to the AccountVerificationSession Object.
Returns
Returns a list of the requested resource with the requested attributes expanded.