GET
/
core
/
kyc
curl --request GET \
  --url https://api.enterprise.sandbox.uphold.com/core/kyc \
  --header 'Authorization: Bearer <token>'
{
  "summary": {
    "reason": "none",
    "status": "ok"
  },
  "processes": {
    "profile": {
      "status": "ok"
    },
    "address": {
      "status": "ok"
    },
    "email": {
      "status": "ok"
    },
    "phone": {
      "status": "ok"
    },
    "identity": {
      "status": "ok",
      "type": "document-submission"
    },
    "proofOfAddress": {
      "status": "ok",
      "type": "electronic-verification"
    },
    "customerDueDiligence": {
      "status": "ok"
    },
    "enhancedDueDiligence": {
      "status": "ok"
    },
    "cryptoRiskAssessment": {
      "status": "ok"
    },
    "selfCategorizationStatement": {
      "status": "ok"
    },
    "screening": {
      "status": "ok"
    },
    "risk": {
      "status": "ok"
    },
    "taxDetails": {
      "status": "ok"
    }
  }
}

The KYC overview endpoint provides a summary of the KYC process for the user.

By default, only the status of each KYC process is included in the response. If you need detailed information, you can use the detailed query parameter to specify the KYC processes you want more detail, which will bring their input, output fields as well as hint if applicable.

Getting the detailed KYC information is more expensive in terms of performance and should be used only when necessary.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 authentication.

Headers

​
Accept-Language
string

The natural language and locale that the client prefers.

Query Parameters

​
detailed
enum<string>[]

Include detailed information about the specified KYC processes. Use this sparingly as its more expensive to retrieve.

Maximum length: 20

Response

200
application/json

KYC overview retrieved.

The KYC overview object.