Auth

Transactions

Access detailed transaction history and balance data

post Transactions/get

post Transactions/get

Why use Transactions?

/transactions delivers a continuous stream of account activity and up to 24 months of history so you can deliver rich insights and experiences to your users.

Access transactions data from thousands of financial institutions
Incorporate enhanced geolocation, merchant, and category information
Stay up-to-date by receiving webhooks for new transactions


                        {
                          "accounts": [
                            {
                              "account_id": "QKKzevvp33HxPWpoqn6rI13BxW4awNSjnw4xv",
                              "balances": {
                                "available": 1203.42,
                                "current": 1274.93,
                                "limit": null
                              },
                              "mask": "9606",
                              "name": "Personal Savings"
                              "official_name": "Plaid Silver Savings",
                              "type": "depository",
                              "subtype": "savings"
                            }
                          ],
                          "transactions": [
                            {
                              "account_id": "XA96y1wW3xS7wKyEdbRzFkpZov6x1ohxMXwep",
                              "transaction_id": "4WPD9vV5A1cogJwyQ5kVFB3vPEmpXPS3qvjXQ",
                              "pending": false,
                              "amount": 78.5,
                              "date": "2014-06-23",
                              "name": "Golden Crepes",
                              "location": {
                                "location": {
                                 "lat": 40.740352,
                                 "lon": -74.001761,
                                 "state": "NY",
                                 "city": "New York",
                                 "address": "262 W 15th St"
                                }
                              },
                              "transaction_type": "place",
                              "category": [
                                "Food and Drink",
                                "Restaurants"
                              ],
                              "category_id": "52544965"
                            }
                          ]
                        }

See full documentation

Instantly authenticate bank accounts for ACH and EFT payments

post Auth/get

Why use Auth?

/auth makes it easy to set up ACH transfers. Once a user links their account via their banking credentials, Plaid retrieves their account and routing numbers. ACH payments can be set up in moments—no micro-deposits required.

Improve throughput on ACH transactions
Simple, mobile-optimized flow
Reduce overdrafts and NSF fees


                        {
                          "accounts": [
                            {
                              "account_id": "mjj9jp92z2fD1mLlpQYZI1gAd4q4LwTKmBNLz",
                              "balances": {
                                "available": 1203.42,
                                "current": 1274.93,
                                "limit": null
                              },
                              "mask": "9606",
                              "name": "Plaid Checking",
                              "official_name": "Plaid Gold Checking",
                              "type": "depository",
                              "subtype": "checking"
                            }
                          ],
                          "numbers": {
                            "ach": [{
                              "account": "9900009606",
                              "account_id": "mjj9jp92z2fD1mLlpQYZI1gAd4q4LwTKmBNLz",
                              "routing": "021000021",
                              "wire_routing": "021000021"
                            }],
                            "eft": []
                          }
                        }

See full documentation

Identity

Verify users’ identities and reduce fraud

post Identity/get

Why use Identity

/identity enables you to verify user identities against what’s on file at the bank.

Collect names, phone numbers, addresses, and emails for each account
Personalize forms with account holder information when users link their bank accounts


                        {
                          "identity": {
                            "addresses": [
                              {
                                "accounts": [
                                  "Plaid Checking 0000",
                                ],
                                "data": {
                                  "zip": "94114",
                                  "state": "CA",
                                  "city": "San Francisco",
                                  "street": "3819 Greenhaven Ln"
                                },
                                "primary": true
                              }
                            ],
                            "emails": [
                              {
                                "primary": true,
                                "type": "personal",
                                "data": "kelly.walters30@example.com"
                              }
                            ],
                            "names": [
                              "Kelly Walters"
                            ],
                            "phone_numbers": [
                              {
                                "primary": true,
                                "type": "home",
                                "data": "4673956022"
                              }
                            ]
                          }
                        }

See full documentation

Balance

Verify real-time account balances

post Balance/get

Why use Balance?

/balance returns the amount of funds in an account in real-time

Reduce overdrafts and NSF fees
Enable account pre-funding


                        {
                          "accounts": [
                            {
                              "account_id": "QKKzevvp33HxPWpoqn6rI13BxW4awNSj",
                              "balance": {
                                "available": 1203.42,
                                "current": 1274.93,
                                "limit": null
                              },
                              "name": "Plaid Checking",
                              "official_name": "Plaid Gold Checking",
                              "type": "depository",
                              "subtype": "checking",
                              "mask": "9606"
                            }
                          ]
                        }

See full documentation

Assets

Verify borrowers’ assets straight from the source

post asset_report/get asset_report/pdf/get

Why use Assets?

/asset_report streamlines the borrower experience and drive efficiencies through digital asset verification. Retrieve a consolidated Asset Report showing account balances, historical transactions, and account holder identity information.

In an Asset Report, get up to 24 months of transaction data as returned by the bank. Also use our Insights feature to get cleaned transaction data with categories, locations, and merchant names.

Integrate Plaid directly into your digital loan application
Save time by eliminating statement uploads and excluding unnecessary accounts
Verify borrower identity with what's on file at the bank on an account-by-account level
Easily identify account owners for joint accounts
Refresh an Asset Report at any time


                        {
                          "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-04-12"
                                      },
                                      {
                                        "current": 110,
                                        "date": "2018-04-11"
                                      },
                                      {
                                        "current": 110,
                                        "date": "2018-04-10"
                                      },
                                      ...
                                    ],
                                    "mask": "0000",
                                    "name": "Plaid Checking",
                                    "official_name": "Plaid Gold Standard 0% Interest Checking",
                                    "owners": [
                                      {
                                        "addresses": [
                                          {
                                            "data": {
                                              "city": "Malakoff",
                                              "state": "NY",
                                              "street": "2992 Cameron Road",
                                              "zip": "14236"
                                            },
                                            "primary": true
                                          },
                                          {
                                            "data": {
                                              "city": "San Matias",
                                              "state": "CA",
                                              "street": "2493 Leisure Lane",
                                              "zip": "93405-2255"
                                            },
                                            "primary": false
                                          }
                                        ],
                                        "emails": [
                                          {
                                            "data": "accountholder0@example.com",
                                            "primary": true,
                                            "type": "primary"
                                          },
                                          {
                                            "data": "accountholder1@example.com",
                                            "primary": false,
                                            "type": "secondary"
                                          },
                                          {
                                            "data": "extraordinarily.long.email.username.123456@reallylonghostname.com",
                                            "primary": false,
                                            "type": "other"
                                          }
                                        ],
                                        "names": [
                                          "Alberta Bobbeth Charleson"
                                        ],
                                        "phone_numbers": [
                                          {
                                            "data": "1112223333",
                                            "primary": false,
                                            "type": "home"
                                          },
                                          {
                                            "data": "1112224444",
                                            "primary": false,
                                            "type": "work"
                                          },
                                          {
                                            "data": "1112225555",
                                            "primary": false,
                                            "type": "mobile1"
                                          }
                                        ]
                                      }
                                    ],
                                    "subtype": "checking",
                                    "transactions": [
                                      ...
                                      {
                                        "account_id": "jW4r4QvdeXcAZNj8J3Dni68DqxQ3laHZwGyBD",
                                        "amount": -500,
                                        "date": "2018-03-25",
                                        "original_description": "United Airlines **** REFUND ****",
                                        "pending": false,
                                        "transaction_id": "wPkQknvpz9HV8bPK465rC6GnyrnlrXCMr9vgm"
                                      },
                                      {
                                        "account_id": "jW4r4QvdeXcAZNj8J3Dni68DqxQ3laHZwGyBD",
                                        "amount": 5.4,
                                        "date": "2018-03-27",
                                        "original_description": "Uber 063015 SF**POOL**",
                                        "pending": false,
                                        "transaction_id": "GM4K4LJqGBu5g8yqjkQJuVnry6rz6zh8Qwkv9"
                                      },
                                      {
                                        "account_id": "jW4r4QvdeXcAZNj8J3Dni68DqxQ3laHZwGyBD",
                                        "amount": 6.33,
                                        "date": "2018-04-09",
                                        "original_description": "Uber 072515 SF**POOL**",
                                        "pending": false,
                                        "transaction_id": "DekykZJWrjf5g7kjRaLvceLZb4avg5CVBDGz5x"
                                      }
                                    ],
                                    "type": "depository"
                                  },
                                  {
                                    "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
                                    "balances": {
                                      "available": 200,
                                      "current": 210
                                    },
                                    "days_available": 730,
                                    "historical_balances": [
                                      {
                                        "current": 210,
                                        "date": "2018-04-12"
                                      },
                                      {
                                        "current": 210,
                                        "date": "2018-04-11"
                                      },
                                      {
                                        "current": 210,
                                        "date": "2018-04-10"
                                      },
                                      ...
                                    ],
                                    "mask": "1111",
                                    "name": "Plaid Saving",
                                    "official_name": "Plaid Silver Standard 0.1% Interest Saving",
                                    "owners": [
                                      {
                                        "addresses": [
                                          {
                                            "data": {
                                              "city": "Malakoff",
                                              "state": "NY",
                                              "street": "2992 Cameron Road",
                                              "zip": "14236"
                                            },
                                            "primary": true
                                          },
                                          {
                                            "data": {
                                              "city": "San Matias",
                                              "state": "CA",
                                              "street": "2493 Leisure Lane",
                                              "zip": "93405-2255"
                                            },
                                            "primary": false
                                          }
                                        ],
                                        "emails": [
                                          {
                                            "data": "accountholder0@example.com",
                                            "primary": true,
                                            "type": "primary"
                                          },
                                          {
                                            "data": "accountholder1@example.com",
                                            "primary": false,
                                            "type": "secondary"
                                          },
                                          {
                                            "data": "extraordinarily.long.email.username.123456@reallylonghostname.com",
                                            "primary": false,
                                            "type": "other"
                                          }
                                        ],
                                        "names": [
                                          "Alberta Bobbeth Charleson"
                                        ],
                                        "phone_numbers": [
                                          {
                                            "data": "1112223333",
                                            "primary": false,
                                            "type": "home"
                                          },
                                          {
                                            "data": "1112224444",
                                            "primary": false,
                                            "type": "work"
                                          },
                                          {
                                            "data": "1112225555",
                                            "primary": false,
                                            "type": "mobile1"
                                          }
                                        ]
                                      }
                                    ],
                                    "subtype": "savings",
                                    "transactions": [
                                      ...
                                      {
                                        "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
                                        "amount": 25,
                                        "date": "2018-02-25",
                                        "original_description": "CREDIT CARD 3333 PAYMENT *//",
                                        "pending": false,
                                        "transaction_id": "LkexeEJ3Ryf5Vw3evRMMIXlLjkRkawIdzm6Ak"
                                      },
                                      {
                                        "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
                                        "amount": -4.22,
                                        "date": "2018-03-22",
                                        "original_description": "INTRST PYMNT",
                                        "pending": false,
                                        "transaction_id": "y7EJEmwgazsjJDVdMZ3QSQBKpaKnQzSjElP71M"
                                      },
                                      {
                                        "account_id": "V3EkERBQXGF5z6Jb9NDkupNeoy1b81cjpWVDe",
                                        "amount": 25,
                                        "date": "2018-03-27",
                                        "original_description": "CREDIT CARD 3333 PAYMENT *//",
                                        "pending": false,
                                        "transaction_id": "dLz7z41KlaSWLbmJqpxXiaqPgJPbn5IgMwymJ"
                                      }
                                    ],
                                    "type": "depository"
                                  },
                                  {
                                    "account_id": "4RWyWq143jIEm7BaqJNKCQyG9Ndnv5iJaENyV",
                                    "balances": {
                                      "available": null,
                                      "current": 5000
                                    },
                                    "days_available": 730,
                                    "historical_balances": [
                                      {
                                        "current": 5000,
                                        "date": "2018-04-12"
                                      },
                                      {
                                        "current": 1000,
                                        "date": "2018-04-11"
                                      },
                                      {
                                        "current": 1000,
                                        "date": "2018-04-10"
                                      },
                                      ...
                                    ],
                                    "mask": "2222",
                                    "name": "Plaid CD",
                                    "official_name": "Plaid Bronze Standard 0.2% Interest CD",
                                    "owners": [
                                      {
                                        "addresses": [
                                          {
                                            "data": {
                                              "city": "Malakoff",
                                              "state": "NY",
                                              "street": "2992 Cameron Road",
                                              "zip": "14236"
                                            },
                                            "primary": true
                                          },
                                          {
                                            "data": {
                                              "city": "San Matias",
                                              "state": "CA",
                                              "street": "2493 Leisure Lane",
                                              "zip": "93405-2255"
                                            },
                                            "primary": false
                                          }
                                        ],
                                        "emails": [
                                          {
                                            "data": "accountholder0@example.com",
                                            "primary": true,
                                            "type": "primary"
                                          },
                                          {
                                            "data": "accountholder1@example.com",
                                            "primary": false,
                                            "type": "secondary"
                                          },
                                          {
                                            "data": "extraordinarily.long.email.username.123456@reallylonghostname.com",
                                            "primary": false,
                                            "type": "other"
                                          }
                                        ],
                                        "names": [
                                          "Alberta Bobbeth Charleson"
                                        ],
                                        "phone_numbers": [
                                          {
                                            "data": "1112223333",
                                            "primary": false,
                                            "type": "home"
                                          },
                                          {
                                            "data": "1112224444",
                                            "primary": false,
                                            "type": "work"
                                          },
                                          {
                                            "data": "1112225555",
                                            "primary": false,
                                            "type": "mobile1"
                                          }
                                        ]
                                      }
                                    ],
                                    "subtype": "cd",
                                    "transactions": [
                                      ...
                                      {
                                        "account_id": "4RWyWq143jIEm7BaqJNKCQyG9Ndnv5iJaENyV",
                                        "amount": 1000,
                                        "date": "2018-01-25",
                                        "original_description": "CD DEPOSIT .INITIAL.",
                                        "pending": false,
                                        "transaction_id": "M8QdQWJx1GS51ZymxjNNILQ7GwjwG1I3qr3RwX"
                                      },
                                      {
                                        "account_id": "4RWyWq143jIEm7BaqJNKCQyG9Ndnv5iJaENyV",
                                        "amount": 1000,
                                        "date": "2018-02-24",
                                        "original_description": "CD DEPOSIT .INITIAL.",
                                        "pending": false,
                                        "transaction_id": "q3Z4ZgvempFnljLVzqxxhPQ3we7eW9sdJy5jP"
                                      },
                                      {
                                        "account_id": "4RWyWq143jIEm7BaqJNKCQyG9Ndnv5iJaENyV",
                                        "amount": 1000,
                                        "date": "2018-03-26",
                                        "original_description": "CD DEPOSIT .INITIAL.",
                                        "pending": false,
                                        "transaction_id": "aZqNqxQAEyHvboB8jazrsbPWNwW6WxU8zRj5kw"
                                      }
                                    ],
                                    "type": "depository"
                                  }
                                ],
                                "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": "accountholder0@example.com",
                              "first_name": "Alberta",
                              "last_name": "Charleson",
                              "middle_name": "Bobbeth",
                              "phone_number": "111-222-3333",
                              "ssn": "123-45-6789"
                            }
                          },
                          "request_id": "pdwYD",
                          "warnings": []
                        }

See full documentation

Income

Understand income and verify employment

post income/get

Why use Income

/income analyzes bank deposits to validate your users’ income and employer information more accurately, eliminating manual paystubs uploads.

View historical income and projected annual income for the current year
Validate employment with associated employer information for income streams


                        {
                          "income": {
                            "income_streams": [
                              {
                                "confidence": 1,
                                "days": 518,
                                "monthly_income": 1601,
                                "name": "PLAID"
                              },
                              {
                                "confidence": 0.95,
                                "days": 415,
                                "monthly_income": 1530,
                                "name": "BAGUETTES INC"
                              }
                            ],
                            "last_year_income": 28072,
                            "last_year_income_before_tax": 38681,
                            "projected_yearly_income": 19444,
                            "projected_yearly_income_before_tax": 26291,
                            "max_number_of_overlapping_income_streams": 2,
                            "number_of_income_streams": 2
                          }
                        }

See full documentation

Products

Learn how you can make the most of financial data

Use cases

There’s so much you can build with us

Docs

Everything you need to integrate with Plaid and learn about our APIs

Get started

Resources

About us

Get to know the people behind the code and the mission behind the work

Who we are

How we handle data

Our products

Our suite of APIs enables developers to easily build great financial products.

Transactions

Why use Transactions?

Auth

Why use Auth?

Identity

Why use Identity

Balance

Why use Balance?

Assets

Why use Assets?

Income

Why use Income