# Lookup Twilio phone number

Canonical URL: https://docs.fuse.init.inc/integrations/twilio/actions/lookups.phone_numbers.get

Lookup phone number metadata with Twilio Lookup v2.

Action ID: `lookups.phone_numbers.get`
Provider: Twilio (`twilio`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

None.

## Input schema fields

- `phone_number`
- `fields`
- `fields[]`

## Output schema fields

- `phone_number`
- `country_code`
- `national_format`
- `calling_country_code`
- `valid`
- `line_type`
- `caller_name`

Provider overview: https://docs.fuse.init.inc/integrations/twilio
Actions index: https://docs.fuse.init.inc/integrations/twilio/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/twilio/actions/lookups.phone_numbers.get
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/twilio/actions