oneapi
Sign in
Telecom v1 / Telecom

Numbering operators

A code list: the licence holders, with how many blocks and how many numbers each of them holds.

GET
https://oneapi.ro/api/telecom/v1/operatori

Query parameters

This route accepts no query parameters.

How it behaves

  • Volumes are allocated resource, not subscribers. An operator can hold millions of numbers without using them — do not read this list as market share.
  • Names are exactly as ANCOM writes them, with diacritics and legal form ("VODAFONE ROMANIA S.A."). For your own matching, use the diacritic-free form.

What it is for

  • Filling an operator dropdown with the exact names from the ANCOM register instead of hand-typed variants.
  • Normalising your own "operator" column to the official licence-holder name.
  • Market analysis on allocated resource: who holds the most numbers, and how much of it is mobile versus fixed.

Response structure

All fields below live inside data[].

FieldTypeDescription
operator string Titularul de licență, cu numele exact din registru.
slug string Adresa operatorului în /operatori/{slug}/blocuri.
blocuri integer Câte blocuri de numerotație deține.
numere integer Câte numere însumează blocurile lui.
blocuri_mobil integer Din care blocuri de numere mobile.
blocuri_fix integer Din care blocuri de numere fixe.

Response examples

GEThttps://oneapi.ro/api/telecom/v1/operatori
{
    "data": [
        {
            "operator": "VODAFONE ROMANIA S.A.",
            "slug": "vodafone-romania-sa",
            "blocuri": 277,
            "numere": 45359464,
            "blocuri_mobil": 42,
            "blocuri_fix": 219
        }
    ]
}

Error codes

CodeSlugWhen it occurs
401neautentificatToken missing, invalid, expired or revoked.
403feature_indisponibilThe current plan does not include the feature the route depends on.
422validareThe route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored.
429cota_depasitaThe plan's monthly quota has been exceeded (see Retry-After).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "The route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored."
    }
}