Lookup

API reference descriptions are provided in English to preserve the exact published contract.

GETNormalise and classify a phone numberlookup.retrieve

Normalise and classify a phone number

GET/v1/accounts/{AC}/lookup/{phone}

lookup.retrieveSDK operation getV1AccountsByAcLookupByPhone

This endpoint does not test or return WhatsApp reachability.

Required scope: contacts:read.

Parameters

phonestring (max 64 chars)Required

GET /v1/accounts/{AC}/lookup/{phone}

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/lookup/phone..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

200OK
400Bad request
401Unauthorized
403Forbidden
404Not found
409Conflict
422Unprocessable
429Too many requests
500Server error
503Unavailable