---
updatedAt: 2026-08-07T08:07:23.000Z
agentTools:
  projectIndex: https://docs.verihubs.com/llms.txt
---

# SMS Delete Blocked Number V2

SMS OTP version change is by introducing a new API version release.<br>

Version changes usually need to be applied immediately to the latest version, in order to get a better API usage experience than the previous version.<br>

The benefits you get if you use a newer version are as follows.
- Decreasing processing time in API Request and Response
- Improve feature in SMS: Blocking Request, Spam Check, Sequential Phone Number, and Blocked Numbers
- Increase RPS in SMS (before 30rps to 50rps)
- Better developer environment to support future developments
- Improve logging and monitoring on our side
- Improved dependencies and improved service stability<br>

This method helps you to delete blocked number from list


# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "servers": [
    {
      "url": "https://api.verihubs.com/"
    }
  ],
  "info": {
    "title": "SMS API Documentation",
    "version": "2.0.0"
  },
  "tags": [
    {
      "name": "SMS & OTP",
      "description": "Get information about SMS OTP & SMS Notifications and Promotions API"
    }
  ],
  "paths": {
    "/v2/sms-otp/blocked-numbers": {
      "delete": {
        "tags": [
          "SMS & OTP"
        ],
        "summary": "SMS Delete Blocked Number V2",
        "description": "SMS OTP version change is by introducing a new API version release.<br>\n\nVersion changes usually need to be applied immediately to the latest version, in order to get a better API usage experience than the previous version.<br>\n\nThe benefits you get if you use a newer version are as follows.\n- Decreasing processing time in API Request and Response\n- Improve feature in SMS: Blocking Request, Spam Check, Sequential Phone Number, and Blocked Numbers\n- Increase RPS in SMS (before 30rps to 50rps)\n- Better developer environment to support future developments\n- Improve logging and monitoring on our side\n- Improved dependencies and improved service stability<br>\n\nThis method helps you to delete blocked number from list\n",
        "operationId": "delete_otp_blocked_v2",
        "parameters": [
          {
            "required": true,
            "schema": {
              "title": "App-ID",
              "type": "string"
            },
            "name": "App-ID",
            "in": "header"
          },
          {
            "required": true,
            "schema": {
              "title": "API-Key",
              "type": "string"
            },
            "name": "API-Key",
            "in": "header"
          },
          {
            "required": true,
            "schema": {
              "title": "msisdn",
              "type": "string"
            },
            "name": "msisdn",
            "description": "Destination number that wants to be deleted form blocked number list",
            "example": 62812634439,
            "in": "query"
          }
        ],
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseDeleteBlockedNumber"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponsePost400"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseSend401"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseSend500"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ResponseDeleteBlockedNumber": {
        "title": "DeleteBlockedNumbers",
        "required": [
          "message"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Succesfully deleted msisdn from blocked list"
          }
        }
      },
      "ResponsePost400": {
        "title": "Error Validation",
        "required": [
          "message"
        ],
        "type": "object",
        "properties": {
          "message": {
            "title": "Message",
            "type": "string",
            "example": "Invalid payload: Msisdn missing"
          }
        }
      },
      "ResponseSend401": {
        "title": "Error Validation",
        "required": [
          "code",
          "message"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "example": 401
          },
          "message": {
            "title": "Message",
            "type": "string",
            "example": "Authorization failed"
          }
        }
      },
      "ResponseSend500": {
        "title": "Error Validation",
        "required": [
          "code",
          "message"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "example": 500
          },
          "message": {
            "title": "Message",
            "type": "string",
            "example": "Internal Server Error"
          }
        }
      }
    }
  }
}
```