oneapi
Sign in
Identificatori v1 / Identificatori

Module coverage

What the module can do: the identifier types it recognises, how many codes the nomenclatures hold and which countries VIES accepts. The entry point before your first validation.

GET
https://oneapi.ro/api/identificatori/v1/acoperire

Query parameters

This route accepts no query parameters.

How it behaves

  • The route is free, like every coverage route on the platform.
  • in_baza: false is not a gap: the module genuinely has no tables. Every check is a standard check digit or structure, which cannot be imported from anywhere. The only external source is VIES, and the only dependency on another module is the county nomenclature from Locations, for licence plates.

What it is for

  • Check which identifier types we cover, before integrating.
  • See that the module holds no data of its own — everything is a standard algorithm, apart from VIES.

Response structure

All fields below live inside data.

FieldTypeDescription
tipuri integer How many identifier types we recognise.
coduri array Their codes, in the specificity order used for detection.
vies.state integer How many states are in the VIES system.
vies.maxim_pe_cerere integer How many VAT numbers can be sent in one request.
vies.sursa string
in_baza boolean Always false: the module holds no data of its own.
observatie string A note on how to read the response: a computation convention or a limit of the data.

Response examples

GEThttps://oneapi.ro/api/identificatori/v1/acoperire
{
    "data": {
        "tipuri": 10,
        "coduri": [
            "vin",
            "lei",
            "isin",
            "iban",
            "bic",
            "cnp",
            "numar_auto",
            "eori",
            "gtin",
            "cui"
        ],
        "vies": {
            "state": 28,
            "maxim_pe_cerere": 50,
            "sursa": "Sistemul VIES al Comisiei Europene, interogat live"
        },
        "in_baza": false,
        "observatie": "Modulul NU are date proprii: toate validările sunt algoritmi de standard (cifre de control, structuri). Singura sursă externă e VIES, iar singura dependență de alt modul e nomenclatorul de județe din Locations, pentru numerele de înmatriculare."
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatToken missing, invalid, expired or revoked.
403modul_interzisThe token has no access to the route's module.
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."
    }
}