Numbers
Delete numbers
DELETE
https://api.smsedge.com/v1/numbers/delete/Deletes one or more numbers from your lists by number ID.
Deleted numbers are not sent to in new campaigns. If some IDs are not found, the response is still 200 and errors lists the missing IDs. To stop all messages to a phone number, use Unsubscribe a number.
Query params
idsstringrequiredComma-separated number IDs. Get them from Get numbers. Send a string, not an array.
Responses
- 200The numbers were deleted.
- 400The ids parameter is missing or is not a string.
- 404None of the IDs are in your lists.
- 503A temporary error. Nothing was deleted. Send the request again.
curl -X DELETE "https://api.smsedge.com/v1/numbers/delete/?ids=63264825474%2C63264825475" \
-H "X-API-KEY: YOUR_API_KEY"[
{
"success": true,
"data": {
"message": "2 number(s) have been deleted successfully"
},
"errors": [],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 14:25:30"
},
"api": {
"version": "v1",
"module": "numbers",
"function": "delete"
},
"user": {
"id": 12345
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.