Status Codes

PearCheck uses standard HTTP response codes to indicate the success or failure of an API request. Most of our failure error codes will contain a message on why the request failed. uses standard HTTP response codes to indicate the success or failure of an API request. Most of our failure error codes will contain a message on why the request failed.

Status Code	Description
200	OK - Worked as expected
208	Already reported - Same verification session id used more than once.
400	Bad Request.
401	Unauthorized.
403	Forbidden.
413	Request size limit.
429	Too Many Requests - Requests are being rate limited. Please contact us.
500	Internal Server Error - Our servers crashed processing the request. Please contact us.

Every status code except 200 is considered an error and you will get a message in the response JSON explaining the error. Sample non-200 response:

    {
        "error": {
            "summary": "verification_type: This field is required.",
            "fields": {
                "verification_type": [
                    "This field is required."
                ]
            }
        }
    }

API Reference

User Verification (KYC) APIs

Business Verification (KYB) APIs