Getting Started With Your API

Response Codes

The LEM Verify API returns errors in the form of:

{
   "type": "bad_request",
   "message: "clientRef needs to be set as a String in the body."
}

LEM Verify uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided. Codes in the 5xx range indicate an error with LEM Verify's servers (these are rare).

CodeTypeDescription
400bad_requestYour request needs to conform with the format set as per the documentation. The message field will suggest why the error might have occured.
401unauthorizedPlease ensure you have set the x-lem-key header and that it's the correct key. This is can be obtained in the Webhooks Connections section of your dashboard.
This could also be from insufficient credits on account for the service or you are not authorised to use the service, such as AML, without being approved first.
404verification_not_foundThe requested verification ID does not exist, ensure it's the System ID returned from the POST Webhook or that from the verification detail section.
422validation_errorThe formatting or type of field sent does not conform to the documentation. The message field will suggest which field(s) are incorrect.
500internal_server_errorThe LEM Server has encountered an error. Please contact [email protected] with the supplied error code.