bird lookup phone-number

bird lookup phone-number [flags]

Look up a phone number

Look up what a phone number is. Returns the serving network, the issuing network, whether the number was ported, its country, and its line type, free with every call. Pass type to buy extra blocks: classification (the allocated service of the range, from an intelligence source, reported beside the free line_type rather than replacing it), porting (whether the number ever moved network, when, and its full history), presence (reachable on the network right now), roaming, sim_swap (when the SIM last changed), and score (0-100 credibility). Every requested block reports its own status, and only the ones reading ok are billed on top of the lookup. Nothing is sent to 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"]
}