eSIM

What is mobile number porting?

Mobile number porting moves an eligible number between service providers so a subscriber can change service while keeping the number.

Family, colleagues and account-recovery services may depend on the subscriber’s existing number. A transfer needs a plan for service continuity as well as the new subscription.

What information does a port need?

The required information depends on the market, the current provider and the provider receiving the number. It can include account-holder details, an account number, transfer credentials and authorization. The subscriber supplies details that match the current provider’s records.

Check eligibility before promising the move. Installing a different eSIM cannot make an unsupported number type or provider path eligible.

What happens while the request is pending?

The receiving provider should track the request and present confirmed scheduling information when available. For a declined request, the receiving provider should show the reported reason. It should explain the specific correction the subscriber can make.

Keep the current service active until the receiving provider confirms when it can end. Canceling prematurely can interfere with the transfer. In Gigs’ port-in process, the required details and request progression depend on the provider path.

What should be checked after completion?

Verify incoming and outgoing calls, SMS and data according to the new plan. Confirm the number attached to the subscriber’s account. Help the subscriber if an included service does not work.

Moving the number, ending the previous plan and settling its final bill are distinct outcomes. The app should show the customer which steps are complete and which still need attention.

In your porting journey, keep the confirmed transfer outcome separate from the new eSIM’s installation state. Customers need both to establish that their number works on the new service.

In short

  1. The number and eSIM are different parts of the move.

    An installed eSIM does not by itself establish that the old number has transferred.

  2. Eligibility depends on the actual provider path.

    Eligibility depends on the market, number and provider path.

  3. Verify the service after the port.

    Test the included calls, messages and data. Resolve remaining billing obligations separately.

Put it into practice.

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

Get an implementation brief

Build your mobile service with Bird.

Bring your markets, plan requirements and customer journey. Explore mobile connectivity with Bird and prepare your first service.

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