Skip to Content
Compliance & Validation

Batch validate & normalize phone numbers

View Markdown (.md)
POST
/api/v1/public/sms/validate-recipients

Normalizes local and international numbers to standard E.164 format, filters out invalid formats, detects country and carrier prefixes, and deduplicates inputs.

Authorization

headerX-Api-Key<token>

SMS Pro API Key (sk_live_... or sk_test_...)

Request Body

application/json
  1. body
recipients*array<string>

Response Body

Validation and normalization summary

application/json
  1. response
status?string
data?
Example Request
curl -X POST 'https://api.smspro.com/api/v1/public/sms/validate-recipients' \  -H 'Content-Type: application/json' \  -d '{  "recipients": [    "string"  ]}'
Example Response
{  "status": "string",  "data": {    "validCount": 0,    "invalidCount": 0,    "duplicateCount": 0,    "validRecipients": [      "string"    ],    "invalidRecipients": [      "string"    ]  }}