POST /asset_report/get
The /asset_report/get
endpoint retrieves the Asset Report in JSON format. Before calling /asset_report/get
, you must first create the Asset Report using /asset_report/create
(or filter an Asset Report using /asset_report/filter
) and then wait for the PRODUCT_READY
webhook to fire, indicating that the Report is ready to be retrieved.
By default, an Asset Report includes transaction descriptions as returned by the bank, as opposed to parsed and categorized by Plaid. You can also receive cleaned and categorized transactions, as well as additional insights like merchant name or location information. We call this an Asset Report with Insights. An Asset Report with Insights provides transaction category, location, and merchant information in addition to the transaction strings provided in a standard Asset Report. To retrieve an Asset Report with Insights, call /asset_report/get
endpoint with include_insights
set to true
.
For latency-sensitive applications, you can optionally call /asset_report/create
with options.add_ons
set to ["fast_assets"]
. This will cause Plaid to create two versions of the Asset Report: one with only current and available balance and identity information, and then later on the complete Asset Report. You will receive separate webhooks for each version of the Asset Report.
Servers
- https://production.plaid.com
- https://sandbox.plaid.com
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
user_token |
String | No |
The user token associated with the User for which to create an asset report for. The latest asset report associated with the User will be returned |
client_id |
String | No |
Your Plaid API |
options |
Object | No |
An optional object to filter or add data to |
options.days_to_include |
Integer | No |
The maximum number of days of history to include in the Asset Report. |
asset_report_token |
String | No |
A token that can be provided to endpoints such as |
fast_report |
Boolean | No |
Default value: false |
include_insights |
Boolean | No |
Default value: false |
secret |
String | No |
Your Plaid API |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.