The Watch API is currently in private beta and the Predict endpoint only supports phone numbers for now. Please contact us to request access.

​
Usage

In order to evaluate the trustworthiness of a phone number, you need to implement complementary Predict and Feedback endpoints. When queried, the Predict endpoint will respond with a prediction of the phone number’s trustworthiness. Indicating whether traffic is expected to be legitimate or suspicious by Prelude’s anti-fraud system.

The API also supports ingestion of real-time events coming from your systems through its Event endpoint. Those events should denote your end-users interactions within your application, and should be accompanied by a confidence level indicating how reliable you deem the event to be.

​
API

The Prelude v2 API is a REST API and uses standard HTTP features and statuses.

The current URL is https://api.prelude.dev/v2.

​
Authentication

To perform requests on the API, you need to provide a v2 API key in the Authorization header.

You can create an API key in the Dashboard, under the API Keys section of the settings.

Example request
curl --request POST \
     --url 'https://api.prelude.dev/v2/*' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer <API_KEY>'

​
Errors

Prelude uses conventional HTTP statuses to indicate the success or failure of a request:

  • Codes in the 2xx range indicate success.
  • Codes in the 4xx range indicate an error that failed given the information provided (e.g. required parameter was omitted or an authentication failed).
  • Codes in the 5xx range indicate an error with Prelude's servers (these are rare).

The Prelude API returns errors using a JSON object in the response body with a machine-readable code and a human-readable message and a param field.

See Errors for more details as well as a list of all possible error codes.