Business v1 / Fonduri europene

Căutare fonduri

Caută finanțări din fonduri europene după ?program=, ?an=, ?judet=, ?beneficiar=. Cel puțin un
filtru. Paginat.

GET

https://oneapi.ro/api/business/v1/fonduri/cauta

Parametri de interogare

NumeTipDescriereValori acceptate

anopțional integer | null Anul contractului de finanţare. ex. 2023ex. 2024

beneficiaropțional string | null Text din denumirea beneficiarului. ex. MUNICIPIUL CLUJ-NAPOCA

judetopțional string | null Filtru pe judeţul beneficiarului. Se acceptă numele cu ori fără diacritice şi codul auto: Cluj, cluj, CJ, Argeș, ARGEŞ, B — toate dau ACELAŞI rezultat. Un judeţ necunoscut dă 422, nu o listă goală. ⚠️ Filtrează pe judeţul normalizat, nu pe textul brut din data[].judet: cele 310 rânduri al căror „judeţ" e o regiune, un oraş ori o listă de judeţe nu se pot atribui unuia singur şi nu apar sub niciun filtru. max 64 car.

programopțional string | null Programul de finanţare, aşa cum îl scrie sursa (ex. „1 - Economic and Social Development"). ex. FAMI

Cum se comportă

Căutare în finanţările europene: după beneficiar, program, an. Baza acoperă zeci de mii de finanţări din portalurile de date deschise.

La ce folosește

Găsirea finanţărilor dintr-un program sau dintr-un an anume.
Verificarea istoricului de beneficiar al unui partener.
Analiza absorbţiei pe programe, pentru rapoarte.

Structura răspunsului

CâmpTipDescriere

data[] array Conţinutul răspunsului.

data[].program string | null Programul de finanţare.

data[].beneficiar string Beneficiarul finanţării.

data[].cui integer | null Codul fiscal.

data[].judet string Judeţul aşa cum îl scrie SURSA, netransformat. ⚠️ Nu e un nomenclator: aceeaşi coloană conţine şi regiuni de dezvoltare, şi oraşe, şi liste de judeţe — 184 de valori distincte pentru 42 de judeţe. Pentru filtrare foloseşte parametrul judet, care merge pe forma normalizată.

data[].titlu string Titlul proiectului.

data[].an integer Anul de referinţă.

data[].data_semnare string Data semnării.

data[].suma number Suma totală.

data[].suma_ue number | null Partea finanţată din fonduri europene.

data[].moneda string Moneda sumei.

meta.paginare.pagina integer Pagina curentă, numărată de la 1.

meta.paginare.per_pagina integer Câte înregistrări are o pagină.

meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.

meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/fonduri/cauta?an=2023

{
    "data": [
        {
            "id": 1747998,
            "program": null,
            "beneficiar": "PARTENERIATUL DINTRE UAT ORAȘ VOLUNTARI, UAT MUNICIPIULUI BUCUREȘTI, UAT COMUNA DASCĂLU, UAT COMUNA GĂNEASA, UAT COMUNA AFUMAȚI, UAT COMUNA PETRĂCHIOAIA ȘI UAT JUDEȚUL ILFOV",
            "cui": null,
            "judet": "Ilfov",
            "titlu": "Reducerea emisiilor de carbon in Orasul Voluntari prin achizitia de autobuze electrice",
            "an": 2023,
            "data_semnare": "2023-11-29",
            "suma": 30502541.57,
            "suma_ue": null,
            "moneda": "RON"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 6,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/fonduri/cauta?per_pagina=3&an=2024

{
    "data": [],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 3,
            "total": 0,
            "pagini": 0
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/fonduri/cauta?per_pagina=3&judet=CJ

{
    "data": [
        {
            "id": 1746544,
            "program": null,
            "beneficiar": "MUNICIPIUL CLUJ-NAPOCA",
            "cui": null,
            "judet": "CLUJ",
            "titlu": "Modernizarea si cresterea eficientei energetice în cladirile publice – Scoala gimnaziala Nicolae Iorga",
            "an": 2020,
            "data_semnare": "2020-10-01",
            "suma": 13702775.63,
            "suma_ue": null,
            "moneda": "RON"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 3,
            "total": 9029,
            "pagini": 3010
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
422	validare	Un parametru nedeclarat ori o valoare care nu trece validarea (`an`, `beneficiar`, `judet`, `program`). Câmpul vinovat e în `detalii`.
422	fara_filtru	Specifică cel puțin un filtru (program/an/judet/beneficiar).
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Un parametru nedeclarat ori o valoare care nu trece validarea (an, beneficiar, judet, program). Câmpul vinovat e în detalii.",
        "detalii": {
            "an": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}