Processor

processorIdentityGet

POST
/processor/identity/get

The /processor/identity/get endpoint allows you to retrieve various account holder information on file with the financial institution, including names, emails, phone numbers, and addresses.

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

ProcessorIdentityGetRequest defines the request schema for /processor/identity/get

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.

processor_token*string

The processor token obtained from the Plaid integration partner. Processor tokens are in the format: processor-<environment>-<identifier>

Response Body

application/json

curl -X POST "https://example.com/processor/identity/get" \  -H "Content-Type: application/json" \  -d '{    "processor_token": "string"  }'
{  "account": {    "account_id": "XMGPJy4q1gsQoKd5z9R3tK8kJ9EWL8SdkgKMq",    "balances": {      "available": 100,      "current": 110,      "iso_currency_code": "USD",      "limit": null,      "unofficial_currency_code": null    },    "mask": "0000",    "name": "Plaid Checking",    "official_name": "Plaid Gold Standard 0% Interest Checking",    "owners": [      {        "addresses": [          {            "data": {              "city": "Malakoff",              "country": "US",              "postal_code": "14236",              "region": "NY",              "street": "2992 Cameron Road"            },            "primary": true          },          {            "data": {              "city": "San Matias",              "country": "US",              "postal_code": "93405-2255",              "region": "CA",              "street": "2493 Leisure Lane"            },            "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",    "type": "depository"  },  "request_id": "eOPkBl6t33veI2J"}