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.
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}

/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.
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}