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
| Code | Slug | When it occurs |
|---|---|---|
| 401 | neautentificat | Token missing, invalid, expired or revoked. |
| 403 | feature_indisponibil | The current plan does not include the feature the route depends on. |
| 422 | validare | The route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored. |
| 429 | cota_depasita | The 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."
}
}