Business v1 / Persoane

Co-administrators

A person's co-directors: the people appearing in the same companies, with the number of companies in common. Paginated.

GET

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

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.
A name alone identifies nobody, and the register does not publish the national ID number. That is why every person carries an identificator (a UUID derived from name + county of birth + date of birth) and a judet_nastere. The date of birth is neither stored nor exposed — it only feeds the identifier. Where the register gives no date of birth (13% of mentions, mostly corporate liquidators), the person stays distinct at each company, so that no link is invented.
The people who appear in the same companies as the given person (co-administrators, co-associates) — a self-join through companies. The basis for people graphs.

What it is for

Building a person graph for network analysis.
Detecting groups that appear together across several companies.
Extending a check from one person to their circle of associates.

Response structure

All fields below live inside data.

FieldTypeDescription

total integer The total.

persoane[].id integer The internal identifier.

persoane[].nume string The name.

persoane[].firme_comune integer How many companies it shares with the queried company.

persoane[].identificator string The person's stable identifier (UUID), derived from name + county of birth + date of birth. Unlike id, it does not change on reimport. Use it to tell whether the administrator of two companies is the same person or two namesakes.

persoane[].judet_nastere null The county of birth, as published by the register. Together with identificator, it tells namesakes apart when displaying them.

Response examples

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

{
    "data": {
        "total": 0,
        "persoane": []
    }
}

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

{
    "data": {
        "total": 4062,
        "persoane": [
            {
                "id": 14639039,
                "identificator": "a476c810-7322-5e70-a2e0-4c73964f48e6",
                "nume": "CATALINOIU OVIDIU",
                "judet_nastere": null,
                "firme_comune": 5
            }
        ]
    }
}

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

{
    "data": {
        "total": 4149,
        "persoane": [
            {
                "id": 14639039,
                "identificator": "a476c810-7322-5e70-a2e0-4c73964f48e6",
                "nume": "CATALINOIU OVIDIU",
                "judet_nastere": null,
                "firme_comune": 5
            }
        ]
    }
}

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