Phone Signals
Receive key phone signals associated with an individual to flag suspicious activities or validate identities.
Phone Signals enables you to retrieve a list of all known phone numbers and associated phone metadata of a given contact. Additionally, any work phone numbers will be returned in clear text. These signals will be returned within the phones
key.
curl -X POST \
https://api.fideo.ai/v3/verify.signals \
-H 'Authorization: Bearer {Your API Key}' \
-H "Content-Type: application/json" \
-d '{
"emails": [
"[email protected]"
],
"phones": [
"+15552227799"
],
"location": {
"addressLine1": "123 Main Street",
"city": "Denver",
"region": "Colorado",
"regionCode": "CO",
"postalCode": "80203"
},
"name": {
"given": "Sally",
"family": "Smith"
},
"profiles": [{
"service": "twitter",
"username": "smith"
}, {
"service": "twitter",
"userid": "123456"
}, {
"service": "linkedin",
"url": "https://www.linkedin.com/in/sallysmi"
}, {
"service": "github",
"url": "https://www.github.com/smith"
}],
}'
{
"phones": [
{
"label": "work",
"value": "+19702255555",
"firstSeenMs": 1350021600,
"lastSeenMs": 1640415600,
"observations": 100,
"confidence": 0.65
}
]
}
Phone Signals Response Properties
Property Name | Type | Description |
---|---|---|
phones[n].value | string | The business phone of an individual, if known, including the country code. |
phones[n].label | string | An indicator of the type of phone. Currently Fideo only returns work phone numbers |
phones[n].firstSeenMs | long | The first time this phone number was seen by Fideo, in milliseconds (13 digit timestamp) |
phones[n].lastSeenMs | long | The most recent time this phone number was seen by Fideo, in milliseconds (13 digit timestamp) |
phones[n].observations | integer | The number of observations in our graph we've seen of an phone number connected to a person's profile based on the associated inputs |
phones[n].confidence | double | Numerical score how confident we are that this data is correct for the individual (0.0-1.0) |
Response Codes & Errors
Response Codes | Message |
---|---|
200 - OK | Your request was successful |
204 - No Content | Individual is not found within Fideo's Identity Graph |
400 - Bad Request | Your request was invalid |
500 - Server Error | Something is broken on Fideo's side. If you encounter this, please contact us at [email protected] for assistance. |
503 - Service Unavailable | There is a transient downstream error condition. We include a 'Retry-After' header dictating when to attempt the call again. |
Updated about 2 months ago