← Back to Docs
recipe

Phone number parser

Extract, validate, and normalize phone numbers from arbitrary text input using a single Meridian endpoint.

Endpoint

POST /v1/parse/phone

Request body

{
  "text": "Call me at +1 (555) 123-4567",
  "default_region": "US"
}

Response

{
  "numbers": [
    {
      "raw": "+1 (555) 123-4567",
      "e164": "+15551234567",
      "national": "(555) 123-4567",
      "country": "US",
      "type": "mobile",
      "valid": true
    }
  ]
}

Notes

  • Supports E.164, national, and international formats
  • Returns all phone numbers found in the input text
  • Set default_region for numbers missing a country code
  • Invalid or impossible numbers return valid: false
← Back to Docs