Number Lookup is no longer owner-only. Organization admins can now administer the Phone Number Details Lookup permission, granting sub-organization user accounts access to the Number Lookup page in the portal and the underlying Number Lookup API.
What's new
- Phone Number Details Lookup permission: a new organization permission admins can add to any permission group. Sub-organization users in that group can run lookups in the portal and call the Number Lookup API from their own accounts.
- Owner access unchanged: the organization owner always has Number Lookup, no configuration required.
- Predictable propagation: access takes effect immediately unless the user ran a lookup in the previous hour, in which case it can take up to an hour.
Why it matters
Teams that run Telnyx through sub-organizations, managed service providers, agencies, and multi-brand companies, used to hit a wall here: Number Lookup was restricted to the organization owner, so verifying carrier and caller-name data meant sharing owner credentials or funneling every lookup through one account. Sharing credentials fails security review, and centralizing lookups breaks the audit trail. Now the org stays in control while the engineers and operations staff who actually need the data get it in their own accounts, governed by the same permission groups admins already use for everything else.
Example use cases
- Managed service providers: give each sub-account's on-call engineer carrier and CNAM lookup access without sharing owner credentials.
- Voice and messaging teams in sub-organizations: verify line type and caller name before routing outbound calls.
- Compliance teams: keep customer-number lookups limited to a single, auditable permission group.
Getting started
- In Mission Control, go to Account Settings → Advanced Features → Organizations and open your permission groups.
- Add the Phone Number Details Lookup permission to a group and add sub-organization users to it.
- Sub-users can then use Number Lookup in the portal or via API.
Learn more in the Get Started with Organizations and Your Number Lookup Guide support articles.












