Authentications

An authentication process may encompass all the validations carried out according to the policy established when the SDK was initialized. These validations and their analyses can include data on the contexts in which the user was situated at the time of the request. Subsequently, based on the defined policy and validation rules, the status of the authentication is determined.

All calls to the API are authenticated and must have the token next to Bearer prefix in the Authorization header of the request. Calls with a missing or invalid access token will return status code 401 ("Unauthorized").

The token used to make requests to the API is the access token generated according to these instructions..

Authentication attempt

Get a authentication attempt based on the provided attempt ID.

get

/authentications/{attemptId}

Path parameters

attemptIdstringrequired

Authentication attempt ID

Example: xxxxxxf41e2fcd832e6xxxxx

Header parameters

Authorizationstringrequired

Identity Authorization Token

Example: Bearer your_token_here

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.identity.combateafraude.com/authentications/{attemptId}' \
  --header 'Authorization: text'

200

400

401

404

500

200

{
  "requestId": "xxxxx-cecd-4643-95c7-xxxxx",
  "id": "xxxxyheu899xxxx",
  "identity": {
    "id": "xxxxyheu899xxxx",
    "name": "John Doe",
    "personId": "000111222",
    "createdAt": "2024-01-01T13:45:24.321Z"
  },
  "policy": {
    "id": "xxxxyheu899xxxx",
    "name": "test",
    "policyId": "test",
    "createdAt": "2024-01-01T13:45:24.321Z"
  },
  "createdAt": "2024-04-04T13:45:24.321Z",
  "context": {
    "device": {
      "info": {
        "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36",
        "browser": {
          "name": "Chrome",
          "version": "127.x.x",
          "major": "127"
        },
        "engine": {
          "name": "Blink",
          "version": "127.x.x"
        },
        "os": {
          "name": "Linux",
          "version": "x86_64"
        },
        "device": {
          "vendor": "text",
          "model": "text",
          "type": "text"
        },
        "cpu": {
          "architecture": "amd64"
        }
      },
      "fingerPrint": "ASDiknh123",
      "providedInfo": {
        "manufacturer": "Apple",
        "model": "iPhone 12",
        "operatingSystem": "IOS",
        "platform": "text"
      },
      "createdAt": "2024-01-01T13:45:24.321Z",
      "type": "web"
    },
    "location": {
      "reverseGeolocation": {
        "formattedAddress": "R. John doe, 221b - alfa, John - SP, 98811-xxx, Brazil",
        "streetName": "Rua John doe",
        "streetNumber": "221b",
        "neighborhood": "alfa",
        "city": "John",
        "region": "São Paulo",
        "regionCode": "SP",
        "country": "Brazil",
        "countryCode": "BR",
        "zipcode": "98811-xxx"
      },
      "location": {
        "type": "Point",
        "accuracy": "12.45",
        "coordinates": [
          -23.560009318584633,
          -46.63763122201826
        ]
      }
    },
    "network": {
      "ip": "127.0.0.1",
      "asCode": 123412,
      "asName": "Net telecom",
      "isVpn": true,
      "location": {
        "city": "São Paulo",
        "region": "São Paulo",
        "regionCode": "SP",
        "country": "Brazil",
        "countryCode": "BR"
      }
    }
  },
  "authenticationMethods": {
    "face_authentication": {
      "status": "approved",
      "attempts": [
        {
          "createdAt": "2024-01-01T13:45:24.321Z",
          "refusalReason": "person_not_alive",
          "providedFace": {
            "signedUrl": "text"
          },
          "expectedFace": {
            "signedUrl": "text"
          },
          "faceMatch": {
            "isMatch": true,
            "similarity": "0.99814697265625"
          },
          "liveness": {
            "isAlive": true
          }
        }
      ]
    },
    "email_authentication": {
      "createdAt": "2024-01-01T13:45:24.321Z",
      "status": "approved",
      "attempts": [
        {
          "expectedCode": "12345678",
          "providedCode": "12345678",
          "sentTo": "text",
          "createdAt": "2024-01-01T13:45:24.321Z",
          "refusalReason": "expired_code"
        }
      ]
    },
    "sms_authentication": {
      "createdAt": "2024-01-01T13:45:24.321Z",
      "status": "approved",
      "attempts": [
        {
          "expectedCode": "12345678",
          "providedCode": "12345678",
          "sentTo": "text",
          "createdAt": "2024-01-01T13:45:24.321Z",
          "refusalReason": "expired_code"
        }
      ]
    }
  },
  "sourceIp": "127.0.0.1 | 2804:d0c:123:xxx:yyy:aaa:321",
  "contextEvaluation": {
    "device_context": {
      "status": "reproved",
      "reason": "MAX_ATTEMPTS_PER_IDENTITY"
    },
    "location_context": {
      "status": "reproved",
      "reason": "MAX_ATTEMPTS_PER_IDENTITY"
    },
    "network_context": {
      "status": "reproved",
      "reason": "MAX_ATTEMPTS_PER_IDENTITY"
    }
  },
  "status": "approved",
  "contextAnalysisResult": "INVALID"
}

Success