Know Your Customer (KYC)

Gravv API provides a Start KYC Verification endpoint to verify your customers. There are two levels of verification:

Basic
Intermediate

Basic

Customers don't need to upload any documents for Basic verification. Use your discretion to move customers to Basic.

Your API request should look like this:

curl --request POST \
     --url https://api.gravv.xyz/v1/risk/start-kyc \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: order_789_attempt_1' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "kyc_level": "basic",
  "customer_id": "c239895a-0436-4287-a37a-c2664f68d187"
}'

Intermediate

Customers must upload documents to reach the Intermediate level. Gravv currently accepts driver’s licenses or international passports.

Customers can't use scanned screenshots of ID documents. They must take a photo or upload a PDF of the document.

Your API request to move customers to Intermediate should look like this:

curl --request POST \
     --url https://api.gravv.xyz/v1/risk/start-kyc \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: order_789_attempt_1' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "kyc_level": "intermediate",
  "documents": [
    {
      "doc_type": "PASSPORT",
      "metadata": {
        "firstName": "John",
        "lastName": "Doe",
        "number": "ID123456789",
        "issuedDate": "2020-01-15T00:00:00.000Z",
        "validUntil": "2030-01-15T00:00:00.000Z",
        "dob": "1990-05-20T00:00:00.000Z",
        "placeOfBirth": "New York, NY"
      },
      "country": "USA",
      "url": "https://example.com/documents/id-card.jpg"
    },
    {
      "doc_type": "PASSPORT"
    }
  ],
  "customer_id": "c239895a-0436-4287-a37a-c2664f68d187"
}
'