Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt

Use this file to discover all available pages before exploring further.

Endpoint

POST /api/v1/number-lookups

Body

FieldTypeRequiredDescription
instanceIdUUIDyesID de l’instance connectée à utiliser
numbersstring[]yes1 à 10 000 numéros au format international

Processing rules

  • moins de 100 numéros : réponse synchrone
  • 100 numéros ou plus : réponse asynchrone 202
  • les numéros valides sont traités côté provider par batchs de 20

Success response 200 ou 202

{
  "data": {
    "mode": "sync",
    "lookupId": "lookup_uuid",
    "status": "done",
    "requested": 2,
    "normalized": 2,
    "checked": 2,
    "onWhatsAppCount": 1,
    "notOnWhatsAppCount": 1,
    "invalidCount": 0,
    "result": {
      "onWhatsApp": [],
      "notOnWhatsApp": [],
      "invalid": []
    }
  }
}

Common errors

CodeHTTPWhen
VALIDATION_ERROR400Invalid body
NOT_FOUND404Instance not found
PROVIDER_ERROR502Verification provider error