bird lookup phone-number

bird lookup phone-number [flags]

Create a phone number lookup

Create a lookup for a phone number's networks, porting state, country, and line type. Pass type to request separately billed classification, porting, presence, roaming, sim_swap, or score blocks. Each block reports its own status, and only blocks with an ok status add a charge; the lookup does not contact the number.

Build the request from flags, a JSON PhoneNumberLookupRequest body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

# print the body shape (no credentials needed)
bird lookup phone-number --example

# the body it prints:

{
  "phone_number": "+31612345678",
  "type": ["classification", "presence"]
}