The Get Plaid Item endpoint returns information about the Plaid Item ID encoded in the JWT passed to this request.
An item represents a single set of credentials at a financial institution. Items are the core object in the Plaid API - all other resources are nested under an item. This endpoint returns essential information about the item. This endpoint does not require a request body.
OK
The item was not found. Check that your JWT is for the correct item.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "item": {
- "available_products": [
- "string"
], - "billed_products": [
- "string"
], - "consent_expiration_time": "2019-08-24T14:15:22Z",
- "institution_id": "string",
- "item_id": "string",
- "update_type": "USER",
}
}The Get Plaid Accounts endpoint returns information about the accounts associated with a single Plaid Item. Include an optional array of account_ids in your request body to filter the repsonse to only select accounts. If no account_ids are provided, all accounts associated with the item will be returned.
object |
OK
No accounts were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "options": {
- "account_ids": [
- "string"
]
}
}{- "accounts": [
- {
- "account_id": "22553132",
- "balances": {
- "available": 1000,
- "current": 1000,
- "iso_currency_code": "USD",
- "limit": 1000,
- "unofficial_currency_code": "USD"
}, - "name": "Plaid Checking",
- "mask": "0000",
- "official_name": "Plaid Gold Checking",
- "type": "depository",
- "subtype": "checking"
}
], - "item": {
- "available_products": [
- "string"
], - "billed_products": [
- "string"
], - "consent_expiration_time": "2019-08-24T14:15:22Z",
- "institution_id": "string",
- "item_id": "string",
- "update_type": "USER",
}
}The Get Plaid Transactions endpoint returns information about the transactions associated with a single Plaid Item. Include any of the following optional parameters in your request body to filter the response:
start_date: The earliest date for which to return transactions. If no start_date is provided, the earliest available transaction will be returned.end_date: The latest date for which to return transactions. If no end_date is provided, the latest available transaction will be returned.account_ids: An array of account IDs for which to return transactions. If no account_ids are provided, transactions for all accounts associated with the item will be returned.object |
OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "options": {
- "account_ids": [
- "string"
], - "start_date": "2019-08-24",
- "end_date": "2019-08-24"
}
}{- "transactions": [
- {
- "account_id": "QKKzevq9K1H9J4RJ1K1yF1K1Z1K1Q1F1K1yF1",
- "account_owner": "string",
- "amount": 4.33,
- "authorized_date": "2017-01-01",
- "authorized_datetime": "2017-01-01T00:00:00Z",
- "category": [
- "string"
], - "category_id": "1805800",
- "check_number": "1001",
- "date": "2017-01-01",
- "datetime": "2017-01-01T00:00:00Z",
- "iso_currency_code": "USD",
- "location": {
- "address": "123 Main St.",
- "city": "San Francisco",
- "country": "US",
- "lat": "37.798738",
- "lon": "-122.403128",
- "postal_code": "94131",
- "region": "CA",
- "store_number": "123"
}, - "merchant_name": "Starbucks",
- "name": "Starbucks",
- "original_description": "Starbucks",
- "payment_channel": "in store",
- "payment_meta": { },
- "pending": false,
- "pending_transaction_id": "123456789",
- "personal_finance_category": null,
- "transaction_code": "PURCHASE",
- "transaction_id": "123456789",
- "transaction_type": "in_store",
- "unofficial_currency_code": "USD"
}
], - "accounts": [
- {
- "account_id": "22553132",
- "balances": {
- "available": 1000,
- "current": 1000,
- "iso_currency_code": "USD",
- "limit": 1000,
- "unofficial_currency_code": "USD"
}, - "name": "Plaid Checking",
- "mask": "0000",
- "official_name": "Plaid Gold Checking",
- "type": "depository",
- "subtype": "checking"
}
], - "item": {
- "available_products": [
- "string"
], - "billed_products": [
- "string"
], - "consent_expiration_time": "2019-08-24T14:15:22Z",
- "institution_id": "string",
- "item_id": "string",
- "update_type": "USER",
}
}The Get Plaid Investment Holdings endpoint returns information about the investment holdings associated with a single Plaid Item. Include any of the following optional parameters in your request body to filter the response:
account_ids: An array of account_ids to retrieve for the Item. An error will be returned if a provided account_id is not associated with the Item.object |
OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "options": {
- "account_ids": [
- "string"
], - "start_date": "2019-08-24",
- "end_date": "2019-08-24"
}
}{- "accounts": [
- {
- "account_id": "22553132",
- "balances": {
- "available": 1000,
- "current": 1000,
- "iso_currency_code": "USD",
- "limit": 1000,
- "unofficial_currency_code": "USD"
}, - "name": "Plaid Checking",
- "mask": "0000",
- "official_name": "Plaid Gold Checking",
- "type": "depository",
- "subtype": "checking"
}
], - "securities": [
- {
- "security_id": "string"
}
], - "holdings": [
- {
- "cost_basis": 0,
- "id": "string",
- "institution_price": 0,
- "institution_price_as_of": "2019-08-24T14:15:22Z",
- "institution_value": 0,
- "iso_currency_code": "string",
- "quantity": 0,
- "security_id": "string",
- "unofficial_currency_code": "string"
}
], - "item": {
- "available_products": [
- "string"
], - "billed_products": [
- "string"
], - "consent_expiration_time": "2019-08-24T14:15:22Z",
- "institution_id": "string",
- "item_id": "string",
- "update_type": "USER",
}, - "is_investments_fallback_item": true
}The Get Plaid Liabilities retrieve various details about an Item with loan or credit accounts. The types of information returned by Liabilities can include balances and due dates, loan terms, and specific details such as the original loan amount and guarantor. Include any of the following optional parameters in your request body to filter the response:
account_ids: An array of account_ids to retrieve for the Item. An error will be returned if a provided account_id is not associated with the Item.object |
OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "options": {
- "account_ids": [
- "string"
], - "start_date": "2019-08-24",
- "end_date": "2019-08-24"
}
}{- "accounts": [
- {
- "account_id": "22553132",
- "balances": {
- "available": 1000,
- "current": 1000,
- "iso_currency_code": "USD",
- "limit": 1000,
- "unofficial_currency_code": "USD"
}, - "name": "Plaid Checking",
- "mask": "0000",
- "official_name": "Plaid Gold Checking",
- "type": "depository",
- "subtype": "checking"
}
], - "liabilities": [
- {
- "credit": [
- {
- "account_id": null,
- "aprs": null,
- "is_overdue": null,
- "last_payment_amount": null,
- "last_payment_date": null,
- "last_statement_issue_date": null,
- "last_statement_balance": null,
- "minimum_payment_amount": null,
- "next_payment_due_date": null
}
], - "mortgage": [
- {
- "account_id": null,
- "account_number": null,
- "current_late_fee": null,
- "escrow_balance": null,
- "has_pmi": null,
- "has_prepayment_penalty": null,
- "interest_rate": null,
- "last_payment_amount": null,
- "last_payment_date": null,
- "loan_type_description": null,
- "loan_term": null,
- "maturity_date": null,
- "next_monthly_payment": null,
- "next_payment_due_date": null,
- "origination_date": null,
- "origination_principal_amount": null,
- "past_due_amount": null,
- "property_address": null,
- "ytd_interest_paid": null,
- "ytd_principal_paid": null
}
], - "student": [
- {
- "account_id": null,
- "account_number": null,
- "disbursement_dates": null,
- "expected_payoff_date": null,
- "guarantor": null,
- "interest_rate_percentage": null,
- "is_overdue": null,
- "last_payment_amount": null,
- "last_payment_date": null,
- "last_statement_issue_date": null,
- "loan_name": null,
- "loan_status": {
- "end_date": null,
- "type": null
}, - "minimum_payment_amount": null,
- "next_payment_due_date": null,
- "origination_date": null,
- "origination_principal_amount": null,
- "outstanding_interest_amount": null,
- "payment_reference_number": null,
- "pslf_status": {
- "estimated_eligibility_date": null,
- "payments_made": null,
- "payments_remaining": null
}, - "repayment_plan": {
- "description": null,
- "type": null
}, - "sequence_number": null,
- "servicer_address": {
- "city": null,
- "region": null,
- "street": null,
- "postal_code": null,
- "country": null
}, - "ytd_interest_paid": null,
- "ytd_principal_paid": null
}
]
}
], - "item": {
- "available_products": [
- "string"
], - "billed_products": [
- "string"
], - "consent_expiration_time": "2019-08-24T14:15:22Z",
- "institution_id": "string",
- "item_id": "string",
- "update_type": "USER",
}
}The Get Plaid Identity Information endpoint returns a range of account holder details stored by the financial institution, such as names, email addresses, phone numbers, and physical addresses. It's important to note that while the retrieval of name data is assured, other pieces of information might not be available. In such cases, these fields will appear as empty arrays if the institution hasn't supplied them. Include any of the following optional parameters in your request body to filter the response:
account_ids: An array of account IDs for which to return transactions. If no account_ids are provided, transactions for all accounts associated with the item will be returned.OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "client_id": "string",
- "secret": "string",
- "access_token": "string",
- "options": {
- "account_ids": [
- "string"
]
}
}{- "accounts": [
- {
- "account_id": "22553132",
- "balances": {
- "available": 1000,
- "current": 1000,
- "iso_currency_code": "USD",
- "limit": 1000,
- "unofficial_currency_code": "USD"
}, - "name": "Plaid Checking",
- "mask": "0000",
- "official_name": "Plaid Gold Checking",
- "type": "depository",
- "subtype": "checking"
}
], - "item": {
- "available_products": [
- "string"
], - "billed_products": [
- "string"
], - "consent_expiration_time": "2019-08-24T14:15:22Z",
- "institution_id": "string",
- "item_id": "string",
- "update_type": "USER",
}
}The Get Plaid Auth Information endpoint provides details of bank account and bank identification numbers (like routing numbers for U.S. accounts) linked with an Item's checking and savings accounts. This includes key account information and balance details, subject to availability. Include any of the following optional parameters in your request body to filter the response:
account_ids: An array of account IDs for which to return transactions. If no account_ids are provided, transactions for all accounts associated with the item will be returned.OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "client_id": "string",
- "secret": "string",
- "access_token": "string",
- "options": {
- "account_ids": [
- "string"
]
}
}{- "accounts": [
- {
- "account_id": "22553132",
- "balances": {
- "available": 1000,
- "current": 1000,
- "iso_currency_code": "USD",
- "limit": 1000,
- "unofficial_currency_code": "USD"
}, - "name": "Plaid Checking",
- "mask": "0000",
- "official_name": "Plaid Gold Checking",
- "type": "depository",
- "subtype": "checking"
}
], - "item": {
- "available_products": [
- "string"
], - "billed_products": [
- "string"
], - "consent_expiration_time": "2019-08-24T14:15:22Z",
- "institution_id": "string",
- "item_id": "string",
- "update_type": "USER",
}
}The Get All Institutions endpoint returns a list of supported financial institutions. Include any of the following optional parameters in your request body to filter the response:
count: The total number of institutions to return. This field is required and limited to 500. offset: The number of institutions to skip in pagination.OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "count": 0,
- "offset": 0
}{- "institutions": [
- {
- "institution_id": "ins_1",
- "name": "Bank of America",
- "products": [
- "assets",
- "auth",
- "balance",
- "transactions",
- "identity",
- "liabilities"
], - "country_codes": [
- "US"
], - "url": null,
- "primary_color": null,
- "logo": null,
- "routing_numbers": [
- "011000138",
- "011200365",
- "011400495"
], - "dtc_numbers": [
- "2236",
- "0955",
- "1367"
], - "oauth": false,
- "status": {
- "item_logins": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.02,
- "error_institution": 0.03,
- "refresh_interval": "NORMAL"
}
}, - "transactions_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "auth": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.03,
- "error_institution": 0.02,
- "refresh_interval": "NORMAL"
}
}, - "identity": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.03,
- "error_institution": 0.02,
- "refresh_interval": "NORMAL"
}
}, - "investments_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "liabilities_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "liabilities": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "investments": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "health_incidents": [
- {
- "start_date": "2019-02-12T08:22:00Z",
- "end_date": null,
- "title": null,
- "incident_updates": null
}
]
}, - "payment_initiation_metadata": null,
- "auth_metadata": null
}
], - "total": 0
}The Get Plaid Institution By Id endpoint returns the specific financial institution corresponding to the institution_id. Include any of the following optional parameters in your request body to filter the response:
institution_id: The ID of the institution to get details about.OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "institution_id": "string"
}{- "institutions": [
- {
- "institution_id": "ins_1",
- "name": "Bank of America",
- "products": [
- "assets",
- "auth",
- "balance",
- "transactions",
- "identity",
- "liabilities"
], - "country_codes": [
- "US"
], - "url": null,
- "primary_color": null,
- "logo": null,
- "routing_numbers": [
- "011000138",
- "011200365",
- "011400495"
], - "dtc_numbers": [
- "2236",
- "0955",
- "1367"
], - "oauth": false,
- "status": {
- "item_logins": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.02,
- "error_institution": 0.03,
- "refresh_interval": "NORMAL"
}
}, - "transactions_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "auth": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.03,
- "error_institution": 0.02,
- "refresh_interval": "NORMAL"
}
}, - "identity": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.03,
- "error_institution": 0.02,
- "refresh_interval": "NORMAL"
}
}, - "investments_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "liabilities_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "liabilities": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "investments": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "health_incidents": [
- {
- "start_date": "2019-02-12T08:22:00Z",
- "end_date": null,
- "title": null,
- "incident_updates": null
}
]
}, - "payment_initiation_metadata": null,
- "auth_metadata": null
}
]
}The Search Plaid Institutions endpoint returns financial institutions that match the query parameters. Include any of the following optional parameters in your request body to filter the response:
query: A string search query to filter down results.OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "query": "string"
}{- "institutions": [
- {
- "institution_id": "ins_1",
- "name": "Bank of America",
- "products": [
- "assets",
- "auth",
- "balance",
- "transactions",
- "identity",
- "liabilities"
], - "country_codes": [
- "US"
], - "url": null,
- "primary_color": null,
- "logo": null,
- "routing_numbers": [
- "011000138",
- "011200365",
- "011400495"
], - "dtc_numbers": [
- "2236",
- "0955",
- "1367"
], - "oauth": false,
- "status": {
- "item_logins": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.02,
- "error_institution": 0.03,
- "refresh_interval": "NORMAL"
}
}, - "transactions_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "auth": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.03,
- "error_institution": 0.02,
- "refresh_interval": "NORMAL"
}
}, - "identity": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": {
- "success": 0.95,
- "error_plaid": 0.03,
- "error_institution": 0.02,
- "refresh_interval": "NORMAL"
}
}, - "investments_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "liabilities_updates": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "liabilities": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "investments": {
- "status": "HEALTHY",
- "last_status_change": "2019-02-12T08:22:00Z",
- "breakdown": null
}, - "health_incidents": [
- {
- "start_date": "2019-02-12T08:22:00Z",
- "end_date": null,
- "title": null,
- "incident_updates": null
}
]
}, - "payment_initiation_metadata": null,
- "auth_metadata": null
}
]
}The Test a Plaid Webhook in the Sandbox endpoint is used to test that code correctly handles webhooks. Include any of the following optional parameters in your request body to filter the response:
webhook_code: The webhook codes that can be fired by this test endpoint.OK
No accounts or transactions were found. Check that your JWT is for the correct item, and that the item ID has active links associated with it.
The JWT provided is invalid or expired. It can also mean that you do not have access to the 'organization' encoded in the JWT.
{- "webhook_code": "string"
}{- "webhook_fired": "string"
}