POST /protect/compute

Use this endpoint to compute a Protect Trust Index score and retrieve fraud attributes.

For link-session models, if the Link session is not yet complete, the endpoint returns HTTP 400 with error_type = INVALID_REQUEST and error_code = FAILED_PRECONDITION.

Servers

https://production.plaid.com
https://sandbox.plaid.com

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`client_id`	String	No	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.
`user`	Object	Yes	Represents an end user for /protect/compute requests.
`user.user_id`	String	No	The Plaid User ID returned from a previous call to `/user/create`. This or `client_user_id` can be provided, not both.
`user.client_user_id`	String	No	A unique ID representing the end user. Maximum of 128 characters. Typically this will be a user ID number from your application. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`.
`model`	String	Yes	The name of the Trust Index model to use for calculating the Trust Index Score, with a major.minor version suffix. Examples include `ti-link-session-2.0` and `ti-identity-2.0`. The model specified may require certain fields within `model_inputs`. For example, `ti-link-session-2.0` requires the `link` field to be provided in `model_inputs`.
`secret`	String	No	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.
`model_inputs`	Object	No	Inputs for the Trust Index model. The `link` field is required for any link session model type.
`model_inputs.link`	Object	No	Inputs for link session Trust Index models.
`model_inputs.link.require_extracted_data`	Boolean	No	Controls whether transaction extraction must be complete before scoring. If `false` (default), returns a score whether or not transaction extraction is complete, as long as the link session is finished; if data has been extracted it will still be included in the score computation. If `true`, returns HTTP 400 with `error_type` = `INVALID_REQUEST` and `error_code` = `FAILED_PRECONDITION` if extraction is still in progress; once data is ready a score will be returned normally.
`model_inputs.link.link_session_id`	String	Yes	A unique identifier for the Link session, used to compute a Trust Index score and fraud attributes.
`model_inputs.sdk`	Object	No	Inputs for Protect SDK Trust Index models.
`model_inputs.sdk.sdk_session_id`	String	Yes	A unique identifier for the Protect SDK session, used to compute a Trust Index score and fraud attributes.

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.