product features
Snapshot of a user’s finances

Retrieve a consolidated summary showing account balances, historical transactions, and account holder identity information

Transaction insights

Review clean transaction data that includes category and merchant name—data is standardised across institutions

PSD2 integrations

Plaid’s integrations are PSD2 compliant, delivering secure and reliable access to the European financial ecosystem

Make an Asset Report request

Use the Assets endpoint to submit a POST request

historical_balance

Calculated data about the historical balances on the account

owners

Account owner(s)’ addresses, emails, names, and phone numbers (multiple where available)

transactions

Transaction data that includes date, description, amount, and category

account_type

Type of account such as current, credit, brokerage, and loan

Retrieve Asset Report request

curl -X POST https://sandbox.plaid.com/asset_report/get \
-H 'Content-Type: application/json' \
-d '{
  "client_id": String,
  "secret": String,
  "access_token": String
  "include_insights": Boolean
}'

Run

Make an Asset Report request

Use the Assets endpoint to submit a POST request

Retrieve Asset Report request

curl -X POST https://sandbox.plaid.com/asset_report/get \
-H 'Content-Type: application/json' \
-d '{
  "client_id": String,
  "secret": String,
  "access_token": String
  "include_insights": Boolean
}'

Asset data

The /asset_report/get or /asset_report/pdf/get endpoints allow you to retrieve a consolidated summary of account balances and transactions in JSON or PDF formats

Retrieve Asset Report response

http code 200
{
  "report": {
    "asset_report_id": "c5b638f9-02b8-45c6-9093-552195149b0c",
    "client_report_id": "123456",
    "date_generated": "2018-04-12T03:32:11Z",
    "days_requested": 730,
    "items": [
      {
        "accounts": [
          {
            "account_id": "jW4r4QvdeXcAZNj8J3Dni68DqxQ3laHZwGyBD",
            "balances": {
              "available": 100,
              "current": 110
            },
            "days_available": 730,
            "historical_balances": [
              {
                "current": 110,
                "date": "2018-03-02",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "current": 110,
                "date": "2018-04-03",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "current": 110,
                "date": "2018-05-04",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              ...
            ],
            "mask": "0000",
            "name": "Plaid Current Account",
            "official_name": "Plaid Gold Current Account",
            "owners": [
              {
                "addresses": [
                  {
                    "data": {
                      "city": null,
                      "region": null,
                      "street": null,
                      "postal_code": "null,
                      "country": null
                    },
                    "primary": true
                  },
                  {
                    "data": {
                      "city": null,
                      "region": null,
                      "street": null,
                      "postal_code": null,
                      "country": null
                    },
                    "primary": false
                  }
                ],
                "emails": [
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  },
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  },
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  }
                ],
                "names": [
                  "Alberta Bobbeth Charleson"
                ],
                "phone_numbers": [
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  },
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  },
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  }
                ]
              }
            ],
            "subtype": "checking",
            "transactions": [
              ...
              {
                "account_id": "jW4r4QvdeXcAZNj8J3Dni68DqxQ3laHZwGyBD",
                "amount": -500,
                "date": "2018-03-02",
                "original_description": "Air France REFUND",
                "pending": false,
                "transaction_id": "wPkQknvpz9HV8bPK465rC6GnyrnlrXCMr9vgm",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "account_id": "jW4r4QvdeXcAZNj8J3Dni68DqxQ3laHZwGyBD",
                "amount": 5.4,
                "date": "2018-04-03",
                "original_description": "Uber 063015",
                "pending": false,
                "transaction_id": "GM4K4LJqGBu5g8yqjkQJuVnry6rz6zh8Qwkv9",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "account_id": "jW4r4QvdeXcAZNj8J3Dni68DqxQ3laHZwGyBD",
                "amount": 6.33,
                "date": "2018-05-04",
                "original_description": "Uber 063015",
                "pending": false,
                "transaction_id": "DekykZJWrjf5g7kjRaLvceLZb4avg5CVBDGz5x",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              }
            ],
            "type": "depository"
          },
          {
            "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
            "balances": {
              "available": 200,
              "current": 210
            },
            "days_available": 730,
            "historical_balances": [
              {
                "current": 210,
                "date": "2018-03-02",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "current": 210,
                "date": "2018-04-03",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "current": 210,
                "date": "2018-05-04",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              ...
            ],
            "mask": "1111",
            "name": "Plaid Savings",
            "official_name": "Plaid Silver Savings Account",
            "owners": [
              {
                "addresses": [
                  {
                    "data": {
                      "city": null,
                      "region": null,
                      "street": null,
                      "Postal_code": null,
                      "country": null
                    },
                    "primary": true
                  },
                  {
                    "data": {
                      "city": null,
                      "region": null,
                      "street": null,
                      "postal_code": null,
                      "country": null
                    },
                    "primary": false
                  }
                ],
                "emails": [
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  },
                  {
                    "data": null,
                    "primary": false,
                    "type": "secondary"
                  },
                  {
                    "data": null,
                    "primary": false,
                    "type": "other"
                  }
                ],
                "names": [
                  "Alberta Bobbeth Charleson"
                ],
                "phone_numbers": [
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  },
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  },
                  {
                    "data": null,
                    "primary": null,
                    "type": null
                  }
                ]
              }
            ],
            "subtype": "savings",
            "transactions": [
              ...
              {
                "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
                "amount": 25,
                "date": "2018-03-02",
                "original_description": "CREDIT CARD 3333 PAYMENT //",
                "pending": false,
                "transaction_id": "LkexeEJ3Ryf5Vw3evRMMIXlLjkRkawIdzm6Ak",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
                "amount": -4.22,
                "date": "2018-04-02",
                "original_description": "INTRST PYMNT",
                "pending": false,
                "transaction_id": "y7EJEmwgazsjJDVdMZ3QSQBKpaKnQzSjElP71M",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
                "amount": 25,
                "date": "2018-05-04",
                "original_description": "CREDIT CARD 3333 PAYMENT //",
                "pending": false,
                "transaction_id": "dLz7z41KlaSWLbmJqpxXiaqPgJPbn5IgMwymJ",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              }
            ],
            "type": "depository"
          },
          {
            "account_id": "4RWyWq143jIEm7BaqJNKCQyG9Ndnv5iJaENyV",
            "balances": {
              "available": null,
              "current": 5000
            },
            "days_available": 730,
            "historical_balances": [
              {
                "current": 5000,
                "date": "2018-04-12",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "current": 1000,
                "date": "2018-04-11",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              {
                "current": 1000,
                "date": "2018-04-10",
                "iso_currency_code": "EUR",
                "unofficial_currency_code": null
              },
              ...
            ],
Note: removed CD from asset report
        "date_last_updated": "2018-04-12T03:32:10Z",
        "institution_id": "ins_109511",
        "institution_name": "Tartan Bank",
        "item_id": "zeWoWyv84xfkGg1w4ox5iQy5k6j75xu8QXMEm"
      }
    ],
    "user": {
      "client_user_id": "123456789",
      "email": null,
      "first_name": "Louis",
      "last_name": "Rousseau",
      "middle_name": "Jacques",
      "phone_number": null,
    }
  },
  "request_id": "pdwYD",
  "warnings": []
}

historical_balance

Calculated data about the historical balances on the account

owners

Account owner(s)’ addresses, emails, names, and phone numbers (multiple where available)

transactions

Transaction data that includes date, description, amount, and category

account_type

Type of account such as current, credit, brokerage, and loan

Consumer transparency and control

Users can review their financial data before choosing to share it with developers, lenders and other third parties

The Assets product provides OppLoans with reliable, high-quality bank data, which makes integrating it into our underwriting process very smooth.
Dave Kamedulski, VP of Product at OppLoans