whatsapp.profile API

whatsapp.profile

live

Check whether an international phone number uses WhatsApp and retrieve the available profile through your connected account.

live coverage

Unipile: all inputs

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

Provider	Status
Unipile	live

Billing

Unit: per_call · unmatched results billed: no
Profile lookup; a missing WhatsApp user is an unbilled no-match.

The exact quote is returned by /v1/inspect before every call and held with headroom on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.routergrowth.com/v1/run \
  -H "Authorization: Bearer $ROUTERGROWTH_API_KEY" \
  -d '{
    "capability": "whatsapp.profile",
    "input": {  },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "account_id": {
      "description": "Account name or ID from whatsapp.accounts. Optional when exactly one account is connected.",
      "type": "string"
    },
    "phone": {
      "description": "International phone number with + and country code, e.g. +14155550123.",
      "type": "string"
    },
    "provider_id": {
      "description": "WhatsApp user ID returned by Unipile (@s.whatsapp.net or @lid). Reuse unchanged.",
      "type": "string"
    }
  },
  "type": "object"
}

Normalized output fields

provider_id · name · phone · picture_url