Implementation

hey@sgnls.co
+44 2032868400

35 Kingsland Rd, London E2 8AA, UK

Signals help companies protect value transfers when a phone number is being used as a unique identifier.

Demo
Implementation
System Status
Suggest a feature

© 2018-2020, All rights reserved

IMPLEMENTATION

Please, follow the instructions to use Signals API when you get your credentials from us. You could also ask for credentials by sending your request to hey@sgnls.co.

Request a Score for a Phone Number

Signals API lets you retrieve scoring for a number based on phone number intelligence, machine learning and a data consortium.

https://api.sgnls.co/v1/score/{PhoneNumber}?email={email}&ip={ip}

where number is the mobile phone number with an international country code for example +441368792875, IP is an Internet Protocol address associated with the checking phone number, for example 188.64.144.36, and email is the email address associated with the checking phone number, for example someone@server.com. Both IP and email parameters are optional.

When you send the number, the score and other details about the phone number come back in the body of the response:

{
"reference_id": "DFHPIFKIC3VHHXV48IY2YCXS6HCMQXMM",
"updated_on": "2020-06-26T09:24:35.000000Z",
"phone_number": "+441368792875",
"phone_type": "Mobile",
"phone_carrier": "Telefonica UK Limited",
"phone_location_city": "London",
"phone_location_country": "UK",
"domain_location_country": "UK",
"domain_spamlisted": 0,
"email_spamlisted": 0,
"transaction_risk_score": 98,
"transaction_risk_level": "High risk level",
"recommendation": "Block",
"description": "Transaction successful"
}

If something goes wrong with your request, the response you get looks like this:

{
"reference_id": "0JIV6XNXZA01ZXR9NBMMBAT1XJ4VWXCS",
"description": "Error",
"updated_on": "2019-08-21T19:06:26.277777Z"
}

Submit a Fraud Event to Signals

Signal is a service that is partly based on a watchlist, which is a proprietary database containing phone numbers of users known to have committed fraud. Signals crowd-sources this information from its customers. Participation is voluntary, but you have to contribute in order to benefit.

https://api.sgnls.co/v1/submit/{PhoneNumber}

When you send the number, the updated results come back in the body of the response:

{
"reference_id": "MBWH76E2AMMEI9DRUBYSANKZYRIFIMEW",
"description": "Transaction successful",
"updated_on": "2020-06-26T07:50:16.985161Z",
"phone_number": "+441368792875"
}

If something goes wrong with your request, the response you get looks like this:

{
"reference_id": "L6EDN7XDYI9D4MCFCR7XZHGXOAIODN4K",
"description": "Error",
"updated_on": "2019-08-21T19:09:05.426758Z"
}

Want to provide feedback? Write to hey@sgnls.co

hey@sgnls.co

+44 2032868400

35 Kingsland Rd,
London E2 8AA, UK

Suggest a feature

Signals help companies protect value transfers when a phone number is being used as a unique identifier.

CONTACT

DEVELOPERS

Demo

Implementation

System Status