KYC History

Endpoint to read a customer's KYC/AML history

Retrieve KYC/AML history

GET https://api.waldo.ai/history/kyc/:customerId

Request Body

Field	Type	Description
customerId*	String	Waldo AI customer id

Headers

Name	Type	Description
Authorization*	String	The token in the format Bearer eyJhbG...
Content-Type*	String	Expected type is application/json

Response

200: OK KYC History Available

{
    "active": {
        "date": 1724244780545,
        "outcome": "REVIEW",
        "documentType": "driving_licence",
        "issuingDate": "2018-08-16",
        "type": "document"
    },
    "history": [
        {
            "date": 1724144769269,
            "outcome": "PASSED",
            "type": "kyc"
        },
        {
            "date": 1724244780545,
            "outcome": "REVIEW",
            "documentType": "driving_licence",
            "issuingDate": "2018-08-16",
            "type": "document"
        }
    ]
}

403: Forbidden Missing authorization header

{
  "code": "NOT_AUTHORIZED",
  "message": "Not authorized."
}

401: Unauthorized Invalid token or expired

{
  "code": "INVALID_TOKEN",
  "message": "Invalid token."
}

403: Forbidden Service not authorized

{
  "code": "NOT_AUTHORIZED",
  "message": "You are not authorized to perform this action. Please contact support for assistance."
}

403: Forbidden Inactive API key

{
  "code": "API_KEY_REVOKED",
  "message": "This API key has been revoked. Please visit the Waldo AI dashboard to review your API key."
}

400: Bad Request Missing query parameters

The query should include the following parameters: customerId

{
  "code": "INVALID_DATA",
  "message": "Invalid customer ID."
}

404: Customer not found

Customer was not found, or has not been evaluated yet.

{
  "code": "NOT_FOUND",
  "message": "KYC history not found."
}