oneapi
Sign in
Business v1 / Meta

Meta / module status

The API version and the state of the Business module.

GET
https://oneapi.ro/api/business/v1/meta

Query parameters

This route accepts no query parameters.

How it behaves

  • The Companies API version and the module status. Coverage by source and data freshness are at /meta/acoperire, the sources at /meta/surse.

What it is for

  • Checking the API version from a client at start-up.
  • An availability check in monitoring.
  • Showing the module's status on a status page.

Response structure

All fields below live inside data.

FieldTypeDescription
modul string The module that answered.
versiune string The module API version.
stare string The module status (e.g. activ) — not any company status.

Response examples

GEThttps://oneapi.ro/api/business/v1/meta
{
    "data": {
        "modul": "business",
        "versiune": "v1",
        "stare": "activ"
    },
    "meta": {
        "sursa": []
    }
}

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."
    }
}