# Verify submitted OTP code
URL: /docs/api-reference/two-factor-verification-otp/verifyOtp

## POST `/api/v1/public/otp/verify`

**Summary:** Verify submitted OTP code
**Operation ID:** `verifyOtp`

Validates the submitted verification code in constant time against active verification session. Enforces maximum attempt limits and prevents replay attacks. Returns the delivery channel used.

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Request Body (`application/json`)

```json
{
  "type": "object",
  "required": [
    "phoneNumber",
    "code"
  ],
  "properties": {
    "phoneNumber": {
      "type": "string",
      "example": "+233241234567"
    },
    "code": {
      "type": "string",
      "example": "849201"
    },
    "otpId": {
      "type": "string",
      "example": "otp-c7a8b9e0-1234"
    }
  }
}
```

### Responses

- **`200`**: Verification outcome with session resolution

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "data": {
      "$ref": "#/components/schemas/OtpVerifyResponse"
    }
  }
}
```
- **`401`**: Authentication failed or API key missing