Validate a recipient list (dry run) | Teekrr

curl -X POST https://api.teekrr.com/broadcasts/validate \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "channel": "sms",
  "recipients": [
    "60123456789",
    "0123456789",
    "not-a-number"
  ]
}'

{
  "data": {
    "summary": {
      "total": 3,
      "valid": 1,
      "invalid": 2
    },
    "valid": [
      {
        "row": 1,
        "value": "+60123456789"
      }
    ],
    "invalid": [
      {
        "row": 2,
        "line": 2,
        "field": "msisdn",
        "value": "0123456789",
        "code": "DUPLICATE",
        "message": "Duplicate recipient (also on row 1)"
      },
      {
        "row": 3,
        "line": 3,
        "field": "msisdn",
        "value": "not-a-number",
        "code": "INVALID_MSISDN",
        "message": "Must be a valid phone number (E.164 or Malaysia 01X format)"
      }
    ]
  }
}

Runs the same recipient validator the send endpoints use and returns per-row diagnostics - without reserving credit, inserting messages, or enqueueing anything. Use it to pre-flight a large recipient list before committing to a broadcast.

Required scope: none beyond a valid API key. Rate limit: 10 requests / 15 min / client

The invalid[].code values are the same ones the send endpoints return in their Recipient validation failed response.

Runs the same recipient validator the send endpoints use and returns per-row diagnostics - **without** reserving credit, inserting messages, or enqueueing anything. Use it to pre-flight a large recipient list before committing to a broadcast. **Required scope:** none beyond a valid API key. **Rate limit:** 10 requests / 15 min / client The `invalid[].code` values are the same ones the send endpoints return in their `Recipient validation failed` response.

Authentication

AuthorizationBearer

Bearer API keys are issued from the in-app /api-management page. Each key has a permission scope (send_sms, send_whatsapp, send_email) and an optional IP whitelist.

The IP whitelist, when set, is matched by exact string equality against the resolved caller IP - CIDR ranges are not supported. An empty whitelist allows any source address.

Bearer API keys are issued from the in-app `/api-management` page. Each key has a permission scope (`send_sms`, `send_whatsapp`, `send_email`) and an optional IP whitelist. The IP whitelist, when set, is matched by **exact string equality** against the resolved caller IP - CIDR ranges are not supported. An empty whitelist allows any source address.

Request

This endpoint expects an object.

channelenumRequired

recipientslist of stringsOptional

recipientVariableslist of objectsOptional

Response

Validation result

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

413

Content Too Large Error

429

Too Many Requests Error

500

Internal Server Error