Sample - Plaid API
POST/beacon/user/reviewDeprecated

Review a Beacon User

Updates the status of a Beacon User after validating the user's related Beacon Reports and report syndications. Supply beacon_user_id and a target status to review, reject, or clear the user. This operation is deprecated.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 body fields

Request identifying the Beacon User and the status to assign.

beacon_user_idstringrequired
ID of the associated Beacon User.
statusstringrequired
A status of a Beacon User. `rejected`: The Beacon User has been rejected for fraud. Users can be automatically or manually rejected. `pending_review`: The Beacon User has been marked for review. `cleared`: The Beacon User has been cleared of fraud.
Allowed:rejectedpending_reviewcleared
client_idstringoptional
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.
secretstringoptional
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.

1 status code
200Returns the updated Beacon User with its new status, version, audit trail, and request identifier.
item_idsarray<string>required
An array of Plaid Item IDs corresponding to the Accounts associated with this Beacon User.
idstringrequired
ID of the associated Beacon User.
versionintegerrequired
The `version` field begins with 1 and increments each time the user is updated.
created_atstringrequired
An ISO8601 formatted timestamp.
updated_atstringrequired
An ISO8601 formatted timestamp. This field indicates the last time the resource was modified.
statusstringrequired
A status of a Beacon User. `rejected`: The Beacon User has been rejected for fraud. Users can be automatically or manually rejected. `pending_review`: The Beacon User has been marked for review. `cleared`: The Beacon User has been cleared of fraud.
Allowed:rejectedpending_reviewcleared
program_idstringrequired
ID of the associated Beacon Program.
client_user_idstringrequired
A unique ID that identifies the end user in your system. Either a `user_id` or the `client_user_id` must be provided. This ID can also be used to associate user-specific data from other Plaid products. Financial Account Matching requires this field and the `/link/token/create` `client_user_id` to be consistent. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`.
userobjectrequired
A Beacon User's data and resulting analysis when checked against duplicate records and the Beacon Fraud Network.
audit_trailobjectrequired
Information about the last change made to the parent object specifying what caused the change as well as when it occurred.
request_idstringrequired
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

Error handling

beacon_user_id and status are required, and status must be rejected, pending_review, or cleared. Use rejected only when a Beacon Report or confirmed report syndication exists, and use cleared only when no active reports or confirmed syndications remain.