Business v1 / Persoane

A person's roles

A person's mandates broken down by role type — director, shareholder, auditor, liquidator — with the company count for each.

GET

https://oneapi.ro/api/business/v1/persoane/{id}/roluri

Path parameters

NameTypeDescriptionExample

idrequired string Internal identifier of the person — obtained from search responses; it is not a personal numeric code.

Query parameters

This route accepts no query parameters.

How it behaves

"Has none" is an answer, not an error. When the entity exists but the list is empty, the response is 200 with an empty list. 404 only means the entity in the path does not exist.
The roles the person holds across companies (administrator, associate, liquidator, etc.), aggregated by type.

What it is for

Telling an active administrator from a mere shareholder, in a scoring model.
Filtering a list of people by type of involvement.
A compact summary of roles, without paging the company list.

Response structure

All fields below live inside data.

FieldTypeDescription

roluri[].rol string The role held (director, shareholder…).

roluri[].nr_firme integer The number of companies.

Response examples

GEThttps://oneapi.ro/api/business/v1/persoane/abecb6a3-ce1d-5648-b7c3-1ab11a3a6046/roluri

{
    "data": {
        "roluri": []
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/85109718-b109-561c-b334-b1171d20ac7a/roluri

{
    "data": {
        "roluri": [
            {
                "rol": "reprezentant al persoanei juridice",
                "nr_firme": 1865
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/1a316a50-157a-5cc5-a545-86f333631344/roluri

{
    "data": {
        "roluri": [
            {
                "rol": "reprezentant al persoanei juridice",
                "nr_firme": 1878
            }
        ]
    }
}

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.
404	negasit	The person [{id}] was not found.
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.",
        "detalii": {
            "id": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}