Business v1 / Firme
Tax vector
The company's filing obligations (the declaration codes: IMP100, CONT412 and so on).
GET
https://oneapi.ro/api/business/v1/firme/{cui}/vector-fiscal
Path parameters
NameTypeDescriptionExample
cuirequired
string
The company tax identification number, without the
RO prefix (e.g. 6719278).
Query parameters
This route accepts no query parameters.
How it behaves
- The tax vector: the company's declarative obligations (IMP100, VAT, profit/income tax, contributions, etc.), from ANAF data. It shows which declarations the company files, and thus indirectly its tax regime.
What it is for
- Inferring a company's tax regime from the returns it is required to file.
- Building a deadline calendar for an accounting client.
- Checking that a client files everything they are supposed to file.
Response structure
All fields below live inside data.
FieldTypeDescription
obligatii[]
string
The obligations declared in the tax vector.
Response examples
GEThttps://oneapi.ro/api/business/v1/firme/6719278/vector-fiscal
{
"data": {
"obligatii": [
"IMP100",
"IMP451",
"IMP461",
"IMP602",
"IMP611",
"IMP701",
"CONT412",
"CONT432",
"CONT480",
"ACCIZE200"
]
}
}
GEThttps://oneapi.ro/api/business/v1/firme/14399840/vector-fiscal
{
"data": {
"obligatii": [
"IMP100",
"IMP602",
"CONT412",
"CONT432",
"CONT480"
]
}
}
GEThttps://oneapi.ro/api/business/v1/firme/2054341/vector-fiscal
{
"data": {
"obligatii": [
"IMP100",
"IMP602",
"CONT412",
"CONT432",
"CONT480"
]
}
}
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 company with tax ID [{cui}] 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": {
"cui": [
"The value sent does not satisfy the parameter rule."
]
}
}
}