New: Streamlined onboarding defaults  View changelog →
Enhanced Due Diligence

Verify Verification Code

Verify an OTP code for customer's contact information.

POST
/v2/customer/{id}/otp-verify

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

Customer ID

Request Body

typestring

Type of verification code

Value in"phone" | "email"
codestring

Verification code

Length1 <= length <= 10

Response Body

curl -X POST "https://api.spherepay.co/v2/customer/customer_f31121c389624d3697cbf3ea8830b7a4/otp-verify" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "email",
    "code": "123456"
  }'
{
  "customerId": "customer_f31121c389624d3697cbf3ea8830b7a4",
  "verifiedAt": "2026-03-09T20:46:31.305Z"
}

{
  "status": 400,
  "detail": "Invalid request parameters",
  "code": "address/invalid",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 404,
  "detail": "Resource not found",
  "code": "resource/not-found",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 422,
  "detail": "Validation failed",
  "code": "validation/failed",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
  "errors": [
    {
      "detail": "Invalid email format",
      "pointer": "/email"
    },
    {
      "detail": "Name is required",
      "pointer": "/name"
    }
  ]
}