Full fraud

Description

With the FULL FRAUD API you will be able to validate three variables in a single API call: email, IP address and phone number.

With email analytics, filter risky users through a deep review of their social networks and other online profiles. Identifies fraudsters and gives access only to legitimate customers.

With IP analysis, get a complete X-ray of your users through the connection with their browser, analyze the IP, check suspicious VPNs, TOR users and risky locations in seconds.

With the analysis of the telephone number of your potential clients, you will be able to verify the country, state, company and the validity of said number; as well as knowing in which social networks it is present. Mitigate risk by discarding fake or risky phones.

HTTP method POST

Endpoint

https://8ehec73psb.execute-api.us-west-2.amazonaws.com/uat/identity/api/idv-govcheck/v1/mx-identity/check-fraud

info

Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Body request (*required)

NAME	REQUIRED	TYPE	DESCRIPTION
idEndPoint*	✅	string	Endpoint Id provided
phone	✅	string	Phone to be validated
ip	✅	string	IP to be validated
email*	✅	string	Email a ser validado

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "b2345cfc7bee621e",
    "timestamp": "2023-05-15 11:59:35",
    "data": {
        "id": "9288299cdc8c",
        "state": "DECLINE",
        "fraud_score": 85,
        "bin_details": null,
        "version": "v2.0",
        "applied_rules": [
            {
                "id": "P102",
                "name": "Port 80 is open on the IP address",
                "operation": "+",
                "score": 1
            },
            {
                "id": "P100",
                "name": "There is 1 suspicious open port on the IP address",
                "operation": "+",
                "score": 4
            },
            {
                "id": "E100",
                "name": "Domain is disposable",
                "operation": "+",
                "score": 80
            },
            {
                "id": "PH100",
                "name": "At least 2 online profiles were found",
                "operation": "+",
                "score": 0
            }
        ],
        "device_details": null,
        "calculation_time": 1194,
        "seon_id": 30081,
        "ip_details": {
            "ip": "1.1.1.1",
            "score": 5,
            "country": "US",
            "state_prov": "California",
            "city": "Los Angeles",
            "timezone_offset": "-07:00",
            "isp_name": "APNIC and CloudFlare DNS Resolver Project",
            "latitude": 34.05223,
            "longitude": -118.24368,
            "type": "CDN",
            "open_ports": [
                80
            ],
            "tor": false,
            "harmful": false,
            "vpn": false,
            "web_proxy": false,
            "public_proxy": false,
            "spam_number": 0,
            "spam_urls": [],
            "id": "f4bd166d-7059-4986-80a3-a3d353c2fb8e",
            "history": {
                "hits": 3235,
                "customer_hits": 188,
                "first_seen": 1573574212,
                "last_seen": 1653948298
            },
            "flags": [
                {
                    "note": "Blacklisted by API",
                    "date": 1620659490,
                    "industry": "Other"
                },
                {
                    "note": "Blacklisted by API",
                    "date": 1649427156,
                    "industry": "Gambling&Casinos"
                },
                {
                    "note": "Blacklisted by API",
                    "date": 1649676623,
                    "industry": "Gambling&Casinos"
                }
            ]
        },
        "email_details": {
            "email": "example@example.com",
            "score": 80,
            "deliverable": null,
            "domain_details": {
                "domain": "example.com",
                "tld": ".com",
                "registered": true,
                "created": "1995-08-14 04:00:00",
                "updated": "2021-08-14 07:01:44",
                "expires": "2022-08-13 04:00:00",
                "registrar_name": "RESERVED-Internet Assigned Numbers Authority",
                "registered_to": null,
                "disposable": true,
                "free": false,
                "custom": false,
                "dmarc_enforced": false,
                "spf_strict": true,
                "valid_mx": false,
                "accept_all": false,
                "suspicious_tld": false,
                "website_exists": true
            },
            "account_details": {
                "apple": {
                    "registered": true
                },
                "ebay": {
                    "registered": null
                },
                "facebook": {
                    "registered": null,
                    "url": null,
                    "name": null,
                },
                "phone_details": {
                    "number": 36301234567,
                    "valid": true,
                    "disposable": false,
                    "type": "MOBILE",
                    "country": "HU",
                    "carrier": "Telekom HU",
                    "score": 0,
                    "account_details": {
                        "facebook": {
                            "registered": true
                        },
                        "google": {
                            "registered": false
                        },
                        "twitter": {
                            "registered": false
                        },
                        "instagram": {
                            "registered": true
                        },
                        "yahoo": {
                            "registered": null
                        },
                        "microsoft": {
                            "registered": null
                        }
                    }
                }
            }
        }
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-4005",
    "message": "-",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/mx-identity/check-fraud"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}