Telgea Developer Docs

Run mobile connectivity from your own software: users, plans and eSIMs, number porting, and usage.

Make your first call in the playground

Paste your API key, pick an endpoint and send it from the browser. There is no sandbox: calls run against your own live organization, so creating a user creates a real user and provisioning creates a real line.

Open the playground

Enterprise API

For companies running their own lines with Portal-issued keys.

Open

Partner API

For partners reselling connectivity under their own brand.

Open

Getting started

  1. 1

    Get your key

    Explained per API: Enterprise · Partner

  2. 2

    Make a first call

    Send List users, a read that changes nothing. Playground

  3. 3

    Provision a line

    Create a plan and deliver the eSIM. Guide

Concepts

Port-in lifecycle

From request to a number on Telgea, and where it can fail.

User plan lifecycle

Creation to a live line, with or without a port-in.

Number and eSIM lifecycle

Number states, the eSIM install flow, suspend and restore.

Resources

Users

5 ops

Manage employees and contractors in your organization.

Teams

3 ops

Group users for billing, access control, and reporting.

User plans

10 ops

Provision SIM cards, phone numbers, and data plans for users.

Numbers

10 ops

The lines you sell: obtain one, look it up, replace its SIM, stop it and end it.

Port-ins

7 ops

Port phone numbers from other providers into Telgea.

Usage

1 op

Retrieve raw voice, SMS, and data usage records for billing and suspension.

Analytics

1 op

Aggregated voice, SMS, and data consumption for reporting and dashboards.

Data pools

2 ops

Track the shared data pool your numbers draw on.

Rates

1 op

Look up pay-as-you-go retail rates for calling, messaging, and roaming data.

Cost thresholds

3 ops

What people may spend per month on a usage type, such as international calls, before it is paused.