Numbers and senders

What is a DID number?

A DID number, for direct inward dialing, is a public number that routes straight to one destination inside a business phone system instead of arriving at a switchboard.

The term predates the technology that carries it. It was specified for ISDN, the digital telephone network that came before IP carried calls. It survives in products that have never used a physical line, which is why it sounds older than the SIP trunk it now runs over.

Where does the term come from?

An ISDN supplementary service, which is why it sounds older than SIP.

The formal reference is ITU-T I.251.1, from the standards arm of the International Telecommunication Union, the UN agency that administers the numbering plan. It is titled Direct-dialling-In. It was published in 1992, under number identification supplementary services in the ISDN series. The service was specified for a world of physical lines. The vocabulary outlived the technology.

What replaced the mechanism is a number pointed at a SIP trunk rather than at a block of copper. The service the caller experiences is identical. The term persists in products that have never touched ISDN.

What is the difference between a DID and an extension?

One is dialable from outside, the other is not.

ThingWho can reach itWhat it costs you
DID numberAnyone, from the public networkA number, per month
ExtensionCallers already inside the phone systemNothing external
SIP trunkIt carries the calls rather than receiving themCapacity, by simultaneous calls
Simultaneous-call capacityNot a destination at allThe limit on concurrent calls

The pairs that get conflated are the last two rows against the first. Holding fifty DID numbers does not mean fifty people can be on the phone at once, because concurrency is a property of the trunk. Nor does one trunk with capacity for fifty calls give anyone a number to dial.

How does a call actually arrive?

Public network, then your provider, then your trunk, then your own routing.

A caller dials the public number. The originating network routes it to whoever holds that number, which is your provider. Your provider delivers it over the SIP trunk you have configured. Your phone system then decides which endpoint rings, using its own extension plan.

The last step is yours rather than the provider's. A provider hands the call to your system with the dialed number attached. Mapping that number to a person, a queue or a menu happens in your phone system rather than in the carrier's.

Does a DID decide what my outbound calls show?

No. Inbound routing and outbound identity are separate.

The number a call arrives on and the number your outgoing calls present are configured in different places. They can differ freely. A business can take calls on fifty DIDs and present one main number on everything it dials out.

That separation is why the two questions have different answers on any platform. CNAM against caller ID covers what the person you call actually sees.

How do I set one up on Bird?

Buy a number with voice capability, then point its inbound route at where you want the calls.

Check capabilities before you buy. GET /v1/numbers/available accepts capabilities=voice and returns only numbers that support it. POST /v1/numbers/orders then takes the exact value the search returned.

Every number starts with its route set to reject, which refuses calls rather than leaving the route unset. So configuring the route is a required step, not a default to override.

Changing that route is a dashboard and command-line operation rather than a public API one. Receiving calls covers the routing options. SIP trunks covers delivering the calls to your own phone system, which keeps its own extensions.

In short

  1. The term comes from the ISDN era.

    ITU-T I.251.1 defines Direct-dialling-In as a supplementary service. The modern equivalent is a number routed over a SIP trunk.

  2. A DID is a public number, an extension is not.

    Anyone can dial a DID from the outside. An extension is internal to the phone system and reachable through it.

  3. The trunk carries the calls, the number attracts them.

    How many numbers you hold and how many simultaneous calls you can take are separate purchases.

  4. Inbound routing is not caller identity.

    Which number a call arrives on is a different question from which number your outbound calls display.

Put it into practice.

Continue with the documentation, guides and examples for this topic. Resources are in English.

Get an implementation brief

Build on the same network.

A test API key is yours immediately. Production unlocks when you add a payment method and verify a sender.

Start with one channel.
Add the others when you're ready.

A test API key is yours immediately. Production unlocks when you add a payment method and verify a sender.

Using Claude Code, Cursor, or Codex? Copy a setup prompt and your agent installs the Bird CLI and skills for you. Pick yours:

Cursor