5️⃣Customer Verification

This step assumes you have successfully created a new customer record using Customer Creationstep and signed a provided challenge

Once the customer challenge has been signed and signature verified, we will proceed to customer screening and verification. Our Sandbox is currently set up to automatically approve the screening stage proceeding to verification. At this stage, you can use our Simulator to verify or reject a newly created customer.

Assuming you would like to verify the customer and proceed with next steps, you need to make an empty PATCH request to /simulator/customers/{customerId}/verify.

Verify customer

Simulates customer verification success

PATCHhttps://api.offblocks.xyz/v1/simulator/customers/{customerId}/verify

Authorization

bearerAuth

Path parameters

customerId*string (uuid)

Unique customer ID

Header parameters

Response

202400401404500

Successful operation

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.offblocks.xyz/v1/simulator/customers/{customerId}/verify', {
    method: 'PATCH',
    headers: {
      "Authorization": "Bearer JWT",
      "Signature": "text",
      "Signature-Input": "text",
      "Idempotency-Key": "123e4567-e89b-12d3-a456-426614174000"
    },
});
const data = await response.json();

If your request was successful, you will receive an empty response with status 202 (Accepted).

The customer will be automatically activated, which you can verify by making a GET request to /customers/{customerId}.

Retrieve customer

Retrieves customer's details

GEThttps://api.offblocks.xyz/v1/customers/{customerId}

Authorization

bearerAuth

Path parameters

customerId*string (uuid)

Unique customer ID

Header parameters

Response

200400401404500

Successful operation

Body

application/json

id*string (uuid)

Unique customer ID

externalId*string

Unique customer ID in a form of an external ID

chainId*string

Unique customer ID in a form of a valid on-chain address. This would normally correspond to customer's EOA wallet address

status*enum

Customer status

initiatingscreeningverifyingrejectedactiveinactive

createdAt*string (date-time)

Date this customer was created (ISO-8601)

updatedAt*string (date-time)

Date this customer was updated (ISO-8601)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.offblocks.xyz/v1/customers/{customerId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT",
      "Signature": "text",
      "Signature-Input": "text"
    },
});
const data = await response.json();

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "text",
  "chainId": "eip155:1:0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb",
  "status": "initiating",
  "createdAt": "2025-02-05T02:08:52.083Z",
  "updatedAt": "2025-02-05T02:08:52.083Z"
}

{
    "chainId": "eip155:280:0x43158f45b5EbD7b1179130130DF00393928C2691",
    "createdAt": "2024-01-12T14:53:02.653457Z",
    "externalId": "27c9aa3b-f12d-43b9-8e91-5264ccc998de",
    "id": "04c5851c-4386-5bd9-9f89-08312f8aee3a",
    "status": "active",
    "updatedAt": "2024-01-12T15:05:32.166028Z"
}

Once the customer has been created and successfully verified, we can proceed to setting up accounts and cards.