POST Request Webhook

LEM Verify provides webhooks to notify you of processed verifications in the form a POST request to your server with the body containing the details in JSON format. Please respond with status 200 and an empty body if you have received the POST request.

Please note you may receive multiple post requests for the same verification, as the result might be updated at a later date with updated information.

The user-agent is LEMVerify/1.0.0

Field	Type	Values	Notes
id	String		UUID for each verification.
type	String	"COMBINATION" for combination verifications "DOCUMENT" for single document verifications "LIVENESS" for standalone liveness verifications "AML_ALERT" for PEP/Sanction/Adverse Media alerts	The type of verification this event notification is for.
friendlyId	String		This will be the same as the clientRef used in the verification request. If this field is not supplied then one will be provided.
processedAt	Signed 32bit integer		The UTC time this verification was processed. It is based on the number of seconds since 00:00:00 1 January 1970.
startedAt	Signed 32bit integer		The UTC time the verification was started by the end user. It is based on the number of seconds since 00:00:00 1 January 1970.
deletionAt	Signed 32bit integer		The UTC time the verification will be permanently deleted from the system. It is based on the number of seconds since 00:00:00 1 January 1970.
result	String	"PASSED" "REFER" "ERROR" "ALERT"	"PASSED" and "REFER" is the LEM Verify recommendation for supplied documentation, liveness video and AML verifications. "ALERT" when the entity has been added to a new PEP/Sanction/Adverse media watchlist. "ERROR" if the state of the verification is in error, please contact [email protected]
referMessage	String		Explanation of why the supplied information should be investigated further. This field is only sent if the result is REFER.
balance	int		Remaining credits on balance.
person	Person	See the Person Object section for more details	Person object containing the extracted and determined information about the individual performing the verification. See the Person Object section for more details. This field will not be present for LIVENESS requests or for AML_ALERT alerts.
documents	array of Document	See the Document Object section for more details.	Array of Document objects containing the extracted and determined information about each document submitted by the individual performing the verification. See the Document Object section for more details. This field will not be present for LIVENESS requests or for AML_ALERT alerts.
liveperson	LivePerson	See the LivePerson Object section for more details	LivePerson object containing estimated information about the individual performing the verification. See the LivePerson Object section for more details. This field will not be present for DOCUMENT requests or for AML_ALERT alerts
alerts	array of Alert	See the Alert Object section for more details	An array of Alert objects containing information about a PEP, Sanction of Adverse Media watchlist they have recently been added to. See the Alert Object section for more details. This field will only be present when a requested on-going screen for an entity joins a new watchlist. This field will only be present for AML_ALERT alerts

An example POST body for a Combination that has passed:

{
  "id": "87dcfc90-3732-11e9-bf24-b52fdb098ba2",
  "type": "COMBINATION",
  "friendlyId": "eYsq3N8nNUk6YXzquWURVV",
  "processedAt": 1550898774,
  "startedAt": 1550898774,
  "deletionAt": 1550907684,
  "result": "PASSED",
  "balance": 999,
  "person": {
  	"title": "MR",
    "forename": "JOHN",
    "surname": "DOE",
    "gender": "MALE",
    "dob": {
      "day": 19,
      "month": 11,
      "year": 1982
    },
    "address": {
      "buildingNumber": "10",
      "address1": "Prime Minister First Lord Of The Treasury",
      "address2": "10 Downing Street",
      "postTown": "London",
      "county": "London",
      "country": "England",
      "postCode": "SW1A 2AA"
    }
  },
  "documents": [
    {
      "type": "DRIVING_LICENSE",
      "documentNumber": "TEST90000123456",
      "expiryDate": {
        "day": 1,
        "month": 11,
        "year": 2019
      },
      "issuingCountry": "GB",
      "result": "REFER"
    },
    {
      "type": "PASSPORT",
      "documentNumber": "990099001",
      "expiryDate": {
        "day": 1,
        "month": 11,
        "year": 2019
      },
      "issuingCountry": "GB",
      "result": "PASSED"
    }
  ],
}