Plaid Developer Portal
Plaid
HomeSDKsAPI ReferenceContext Plugin
Item

itemApplicationList

POST
/item/application/list

List a user’s connected applications

Authorization

PLAID-CLIENT-ID PLAID-SECRET Plaid-Version
PLAID-CLIENT-ID<token>

In: header

PLAID-SECRET<token>

In: header

Plaid-Version<token>

In: header

Request Body

application/json

Request to list connected applications for a user.

client_id?string

Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.

secret?string

Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.

access_token?|

The access token associated with the Item data is being requested for.

Response Body

application/json

application/json

curl -X POST "https://example.com/item/application/list" \  -H "Content-Type: application/json" \  -d '{}'
{  "request_id": "string",  "applications": [    {      "application_id": "string",      "name": "string",      "logo": "string",      "logo_url": "string",      "application_url": "string",      "reason_for_access": "string",      "created_at": "2020-01-01",      "product_data_types": [        "ACCOUNT_BALANCE"      ],      "scopes": {        "product_access": {          "statements": true,          "identity": true,          "auth": true,          "transactions": true        },        "accounts": [          {            "unique_id": "string",            "authorized": true          }        ],        "new_accounts": true      },      "requested_scopes": {        "required_product_access": {          "statements": true,          "identity": true,          "auth": true,          "transactions": true        },        "optional_product_access": {          "statements": true,          "identity": true,          "auth": true,          "transactions": true        },        "account_filters": {          "depository": [            "string"          ],          "credit": [            "string"          ],          "loan": [            "string"          ],          "investment": [            "string"          ]        },        "account_selection_cardinality": "SINGLE_SELECT"      }    }  ]}

itemRemove POST

The `/item/remove` endpoint allows you to remove an Item. Once removed, the `access_token` associated with the Item is no longer valid and cannot be used to access any data that was associated with the Item. Note that in the Development environment, issuing an `/item/remove` request will not decrement your live credential count. To increase your credential account in Development, contact Support. Also note that for certain OAuth-based institutions, an Item removed via `/item/remove` may still show as an active connection in the institution's OAuth permission manager.

itemPublicTokenExchange POST

Exchange a Link `public_token` for an API `access_token`. Link hands off the `public_token` client-side via the `onSuccess` callback once a user has successfully created an Item. The `public_token` is ephemeral and expires after 30 minutes. The response also includes an `item_id` that should be stored with the `access_token`. The `item_id` is used to identify an Item in a webhook. The `item_id` can also be retrieved by making an `/item/get` request.