PROTECT+ Risk Detection

PROTECT+ Risk Detection is a multi-level risk detection solution that analyzes inbound call traffic with continuous data updates to detect spam and scam activity on a call-by-call basis in real time.

This guide walks you through step-by-step details on how to start using PROTECT+ Risk Detection.

Pre-Requisites

A signed agreement is required prior to rendering service. To initiate an agreement, connect with one of our sales representatives.
Create or log in to your Customer Portal account
Upon Registering the business it must meet First Orion vetting requirements to be an Approved business. the business it must meet First Orion vetting requirements to be an Approved business.
Understanding of First Orion's Authentication Endpoint
Tool/Service to invoke API Endpoints (cURL examples shown here)
Access to First Orion's Lab environment is optional

Integration

Dedicated Support for REST API Integration with a data element.

Understanding the API Flow.

Get the businesses API auth token using the Access Token endpoint.
Send inbound calling phone number to the PROTECT+ API endpoint.
Assess the results from the API.

Understanding the API call.

This endpoint requires these pieces of information

In Header: Auth Token
In Body: aNumber (incoming phone number)

curl --request POST \
     --url https://api.firstorion.com/call-protection/v2 \
     --header 'Authorization: Token String' \
     --header 'content-type: application/json' \
     --data '
{
  "aNumber": "+15017685432"
}
'

{
  "body": {
    "aNumber": "+15017685432",
    "riskLevel": "High",
    "category": "SCAM"
  },
  "error": null
}

Reponse

This will return two areas to base the judgement on: Risk Level and Category.

Risk Levels

LOW, MEDIUM, HIGH