Business v1 / Firme

Path between two companies

Whether two companies are connected and THROUGH WHOM: the chain of people linking them, with each person's role in each company. The answer gives the path, not merely that one exists.

GET

https://oneapi.ro/api/business/v1/firme/{cui}/conexe/{cui2}

Path parameters

NameTypeDescriptionExample

cuirequired string The company tax identification number, without the RO prefix (e.g. 6719278).

cui2required string Tax ID of the second company in the pair — the link is described between {cui} and {cui2}.

Query parameters

This route accepts no query parameters.

How it behaves

Searches the path in the connection graph between two companies: the chain of shared people that links them, up to a given depth. If there is no link below the threshold, it returns empty.
The same path search, but by the endpoint tax IDs, is also available at /graf/cale.

What it is for

Checking a suspected affiliation between a customer and a supplier.
Documenting the link between two parties to a transaction, for transfer pricing.
Detecting conflicts of interest in a procurement procedure.

Response structure

All fields below live inside data.

FieldTypeDescription

persoane[].id integer The internal identifier.

persoane[].nume string The name.

persoane[].rol_1 string The person's role in the first company of the pair.

persoane[].rol_2 string The person's role in the second company.

Response examples

GEThttps://oneapi.ro/api/business/v1/firme/42154595/conexe/51015782

{
    "data": {
        "persoane": [
            {
                "id": 14208190,
                "nume": "ANCA CĂTĂLIN-DANIEL",
                "rol_1": "administrator",
                "rol_2": "administrator"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/6719278/conexe/16114842

{
    "data": {
        "persoane": [
            {
                "id": 16740925,
                "nume": "SPULBER MIHAI-ADRIAN",
                "rol_1": "administrator",
                "rol_2": "administrator"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/conexe/16114842

{
    "data": {
        "persoane": []
    }
}

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	One of the companies does not exist.
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": {
            "cui": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}