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://api.msla-id.com/experience-background-fraud-api-v1/api/idv-govcheck/v1/identity/check-fraud

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

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
email*	✅	string	Email to be validated
phone		string	Phone with international prefix. Present and blank is rejected
ip		string	IP to be validated. Present and blank is rejected

Status code responses

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

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "b2345cfc7bee621e",
    "timestamp": "2023-05-15 11:59:35",
    "data": {
        "id": "67c2810c2de1",
        "state": "APPROVE",
        "fraudScore": 1.0,
        "binDetails": {
            "cardBin": "414141",
            "binBank": "VERMONT NATIONAL BANK",
            "binCard": "VISA",
            "binType": "CREDIT",
            "binLevel": "CLASSIC",
            "binCountry": "UNITED STATES",
            "binCountryCode": "US",
            "binWebsite": "www.vermontnationalbank.com",
            "binPhone": "+1 802 476 0030",
            "binValid": true,
            "cardIssuer": "VISA"
        },
        "version": "v2",
        "appliedRules": [
            {
                "id": "PH101",
                "name": "1 online profile was found",
                "operation": "+",
                "score": 1
            }
        ],
        "calculationTime": 2327,
        "seonId": 12602,
        "ipDetails": {
            "ip": "190.210.2.1",
            "score": null,
            "country": "AR",
            "stateProv": "Buenos Aires F.D.",
            "city": "Buenos Aires",
            "timezoneOffset": "-03:00",
            "ispName": "NSS S.A.",
            "latitude": -34.6037,
            "longitude": -58.3816,
            "type": null,
            "openPorts": [],
            "tor": false,
            "vpn": false,
            "webProxy": false,
            "publicProxy": false,
            "spamNumber": 0,
            "spamUrls": []
        },
        "emailDetails": {
            "email": "cliente@gmail.com",
            "score": 2.11,
            "deliverable": true,
            "domainDetails": {
                "domain": "gmail.com",
                "tld": ".com",
                "registered": true,
                "disposable": false,
                "free": true
            }
        },
        "phoneDetails": {
            "number": 5491112345678,
            "valid": true,
            "disposable": false,
            "type": "mobile",
            "country": "AR",
            "carrier": null,
            "score": 1,
            "accountDetails": {
                "facebook": {
                    "registered": true
                }
            }
        }
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3001",
    "message": "Bad request - Invalid or incomplete input data",
    "data": null
}

Response 401 status code

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

Response 404 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1002",
    "message": "Data not found."
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration.",
    "data": null
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}