Plaid logo
Docs
ALL DOCS

API

  • Overview
  • Libraries
  • API versioning
  • Postman Collection
  • Webhooks
Payments and Funding
  • Auth
  • Balance
  • Identity
  • Signal
  • Transfer
  • Investments Move
  • Payment Initiation
  • Virtual Accounts
Financial Insights
  • Transactions
  • Investments
  • Liabilities
  • Enrich
KYC/AML and anti-fraud
  • Look up Dashboard users
  • Identity Verification
  • Monitor
  • Beacon (beta)
Instant Onboarding
  • Layer
Credit and Underwriting
  • Consumer Report (by Plaid Check)
  • Assets
  • Statements
  • Income
Fundamentals
  • Items
  • Accounts
  • Institutions
  • Sandbox
  • Link
  • Users
  • Consent
  • Network
Partnerships
  • Processor tokens
  • Processor partners
  • Reseller partners
Plaid logo
Docs
Close search modal
Ask Bill!
Ask Bill!
Hi! I'm Bill! You can ask me all about the Plaid API. Try asking questions like:
  • Why is /transactions/sync/ better than /get?
  • What is Remember Me?
  • Can you show code for getting a credit card APR in Ruby?
Note: Bill isn't perfect. He's just a robot platypus that reads our docs for fun. You should treat his answers with the same healthy skepticism you might treat any other answer on the internet. This chat may be logged for quality and training purposes. Please don't send Bill any PII -- he's scared of intimacy. All chats with Bill are subject to Plaid's Privacy Policy.
Plaid.com
Log in
Get API Keys
Open nav

Dashboard User Audit API

API reference for viewing Dashboard users for Monitor and Beacon

These endpoints are used to look up a Dashboard user, as referenced in an audit_trail object from the Monitor or Beacon APIs.

Endpoints
/dashboard_user/getRetrieve information about Dashboard user
/dashboard_user/listList Dashboard users

/dashboard_user/get

Retrieve a dashboard user

The /dashboard_user/get endpoint provides details (such as email address) about a specific Dashboard user based on the dashboard_user_id field, which is returned in the audit_trail object of certain Monitor and Beacon endpoints. This can be used to identify the specific reviewer who performed a Dashboard action.

dashboard_user/get

Request fields

dashboard_user_id
requiredstring
ID of the associated user. To retrieve the email address or other details of the person corresponding to this id, use /dashboard_user/get.
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.
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.
Select Language
1const request: DashboardUserGetRequest = {
2 dashboard_user_id: 'usr_1SUuwqBdK75GKi',
3};
4
5try {
6 const response = await client.dashboardUserGet(request);
7} catch (error) {
8 // handle error
9}
dashboard_user/get

Response fields and example

id
string
ID of the associated user. To retrieve the email address or other details of the person corresponding to this id, use /dashboard_user/get.
created_at
string
An ISO8601 formatted timestamp.

Format: date-time
email_address
string
A valid email address. Must not have leading or trailing spaces and address must be RFC compliant. For more information, see RFC 3696.

Format: email
status
string
The current status of the user.

Possible values: invited, active, deactivated
request_id
string
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
1{
2 "id": "54350110fedcbaf01234ffee",
3 "created_at": "2020-07-24T03:26:02Z",
4 "email_address": "user@example.com",
5 "status": "active",
6 "request_id": "saKrIBuEB9qJZng"
7}
Was this helpful?

/dashboard_user/list

List dashboard users

The /dashboard_user/list endpoint provides details (such as email address) all Dashboard users associated with your account. This can use used to audit or track the list of reviewers for Monitor, Beacon, and Identity Verification products.

dashboard_user/list

Request fields

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.
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.
cursor
string
An identifier that determines which page of results you receive.
Select Language
1try {
2 const response = await client.dashboardUserList({});
3} catch (error) {
4 // handle error
5}
dashboard_user/list

Response fields and example

dashboard_users
[object]
List of dashboard users
id
string
ID of the associated user. To retrieve the email address or other details of the person corresponding to this id, use /dashboard_user/get.
created_at
string
An ISO8601 formatted timestamp.

Format: date-time
email_address
string
A valid email address. Must not have leading or trailing spaces and address must be RFC compliant. For more information, see RFC 3696.

Format: email
status
string
The current status of the user.

Possible values: invited, active, deactivated
next_cursor
nullablestring
An identifier that determines which page of results you receive.
request_id
string
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
1{
2 "dashboard_users": [
3 {
4 "id": "54350110fedcbaf01234ffee",
5 "created_at": "2020-07-24T03:26:02Z",
6 "email_address": "user@example.com",
7 "status": "active"
8 }
9 ],
10 "next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
11 "request_id": "saKrIBuEB9qJZng"
12}
Was this helpful?
Developer community
GitHub
GitHub
Stack Overflow
Stack Overflow
YouTube
YouTube
Discord
Discord