WelcomeBun venit

Fint exposes a JSON API that lets developers integrate Romanian financial services into their app: open-banking statements, e-invoicing, company lookups and official exchange rates.

Fint expune un API JSON care permite dezvoltatorilor să integreze servicii financiare românești în aplicația lor: extrase bancare open banking, facturare electronică, căutări de companii și cursuri oficiale de schimb.

ServicesServicii

Fint exposes multiple independent services, each activated separately on a company license. You can use any service on its own or combine them: for example, use eFactura alone to handle Romanian e-invoicing, pair it with Extrase to reconcile bank transactions against invoices, or use Info CUI and Schimb valutar as utility services in any financial workflow. Each company API key you create specifies exactly which services it is allowed to call.

Fint expune mai multe servicii independente, fiecare activat separat pe licența unei companii. Poți folosi orice serviciu individual sau le poți combina: de exemplu, folosește eFactura singur pentru facturarea electronică românească, asociază-l cu Extrase pentru reconcilierea tranzacțiilor bancare cu facturile, sau folosește Info CUI și Schimb valutar ca servicii utilitare în orice flux financiar. Fiecare cheie API de companie pe care o creezi specifică exact ce servicii are voie să apeleze.

Base URLURL de bază

All API requests are made to the base URL:

Toate cererile API se fac către URL-ul de bază:

https://api.fint.ro

Every request must be authenticated with two API keys. See Authentication to get started, or jump to the Quick Start for your first call. Shared response and error conventions are documented under Conventions.

Fiecare cerere trebuie autentificată cu două chei API. Consultă Autentificare pentru a începe, sau treci la Start rapid pentru primul apel. Convențiile comune pentru răspunsuri și erori sunt documentate la Convenții.

Account modelModel de cont

Fint structures access around three entities: an organization, the companies it owns, and the users who belong to it. Understanding this hierarchy is the foundation for working with API keys and services.

Fint structurează accesul în jurul a trei entități: o organizație, companiile pe care le deține și utilizatorii care aparțin organizației. Înțelegerea acestei ierarhii este baza pentru lucrul cu cheile API și serviciile.

OrganizationOrganizație

An organization is the top-level entity registered on Fint. It is the billing unit and owns everything beneath it: companies, API keys, and team members. Every API request must be authenticated with the organization key (X-Org-Key), which you create under User menu → API → Chei API in the Fint UI.

Organizația este entitatea de nivel superior înregistrată pe Fint. Este unitatea de facturare și deține tot ce se află sub ea: companii, chei API și membri ai echipei. Fiecare cerere API trebuie autentificată cu cheia de organizație (X-Org-Key), pe care o creezi în Meniu utilizator → API → Chei API în interfața Fint.

An organization can own multiple companies, each representing a distinct legal entity or operational scope. This makes Fint suitable not only for businesses integrating their own financial operations, but also for software companies and SaaS platforms that embed Fint as a third-party provider for their clients: each client company can be managed as a separate company under the same organization.

O organizație poate deține mai multe companii, fiecare reprezentând o entitate juridică sau un domeniu operațional distinct. Asta face Fint potrivit nu doar pentru afaceri care își integrează propriile operațiuni financiare, ci și pentru companii de software și platforme SaaS care integrează Fint ca furnizor terț pentru clienții lor: fiecare companie client poate fi gestionată ca o companie separată sub aceeași organizație.

Company (license)Companie (licență)

A company, also called a license, is the operational unit within an organization. Each company typically corresponds to a Romanian legal entity with its own CUI. Companies activate services independently: a company may have Extrase and eFactura enabled while another in the same organization has only Info CUI.

O companie, numită și licență, este unitatea operațională din cadrul unei organizații. Fiecare companie corespunde de obicei unei entități juridice românești cu propriul CUI. Companiile activează serviciile independent: o companie poate avea Extrase și eFactura activate, iar alta din aceeași organizație poate avea doar Info CUI.

Each company holds one or more company-level API keys (X-Api-Key), created under Configurare → Chei API in the Fint UI sidebar for the active company. Every company key is scoped to exactly one company and to a chosen subset of that company's active services. A request made with a company key always acts on that specific company.

Fiecare companie deține una sau mai multe chei API de nivel companie (X-Api-Key), create în Configurare → Chei API din bara laterală Fint, pentru compania activă. Fiecare cheie de companie este limitată la exact o companie și la un subset ales din serviciile active ale companiei. O cerere făcută cu o cheie de companie acționează întotdeauna asupra acelei companii.

Users and rolesUtilizatori și roluri

Users are team members invited to an organization. Each user has one of two roles:

Utilizatorii sunt membri ai echipei invitați într-o organizație. Fiecare utilizator are unul din două roluri:

• Admin: full control over the organization, including managing companies, inviting and removing users, creating and deleting API keys, billing, and configuring service consents.
• Admin: control complet asupra organizației, inclusiv gestionarea companiilor, invitarea și eliminarea utilizatorilor, crearea și ștergerea cheilor API, facturare și configurarea consimțămintelor pentru servicii.
• User: operational access to the platform with limited administrative capabilities. Admins define which actions a user may perform.
• User: acces operațional la platformă cu capabilități administrative limitate. Adminii definesc ce acțiuni poate efectua un utilizator.

User roles are managed entirely in the Fint UI and do not affect API key permissions directly. API access is controlled by the key's own service scope, regardless of the role of the person who created the key.

Rolurile utilizatorilor sunt gestionate integral în interfața Fint și nu afectează direct permisiunile cheilor API. Accesul la API este controlat de domeniul de servicii al cheii, indiferent de rolul persoanei care a creat cheia.

How it maps to the APICum se reflectă în API

Every API request carries both keys: X-Org-Key identifies the organization; X-Api-Key identifies the company and enforces its service scope. You never pass a company ID or CUI as an authorization parameter; Fint resolves both from the keys and validates that the company key belongs to the organization key's organization.

Fiecare cerere API poartă ambele chei: X-Org-Key identifică organizația; X-Api-Key identifică compania și aplică domeniul ei de servicii. Nu trimiți niciodată un ID de companie sau CUI ca parametru de autorizare; Fint le rezolvă pe ambele din chei și validează că cheia de companie aparține organizației cheii de organizație.

See Authentication for the full list of header requirements and error codes.

Consultă Autentificare pentru lista completă a cerințelor de header și codurilor de eroare.

Quick StartStart rapid

Make your first authenticated request in a few minutes.

Fă prima cerere autentificată în câteva minute.

StepsPași

1. Make sure you have an active company with the service activated Fint requires at least one active company (license) before the API can be used. A first company is created automatically when you sign up; you can add more from the dashboard billing / subscription page or, on the Enterprise plan, via the Organization API. The company must also have the service you intend to call (eFactura, Extrase, Info CUI, Schimb valutar) activated. See the Account model for the organization → company hierarchy.
2. Asigură-te că ai o companie activă cu serviciul activat Fint necesită cel puțin o companie activă (licență) înainte de a putea folosi API-ul. O primă companie este creată automat la înregistrare; poți adăuga altele din pagina de facturare / abonament a panoului sau, pe planul Enterprise, prin API-ul Organizație. Compania trebuie să aibă și serviciul pe care vrei să-l apelezi (eFactura, Extrase, Info CUI, Schimb valutar) activat. Vezi Modelul de cont pentru ierarhia organizație → companie.
3. Get your organization key In the Fint dashboard, open the user menu → API → Chei API and create an organization key. This identifies your organization.
4. Obține cheia de organizație În panoul Fint, deschide meniul utilizator → API → Chei API și creează o cheie de organizație. Aceasta identifică organizația ta.
5. Get a company key Switch to the company you want to act on, then go to Configurare → Chei API in the sidebar and create a company key. Choose which services the key may call - each must be active on the company (eFactura, Extrase, Info CUI, Schimb valutar).
6. Obține o cheie de companie Comută la compania asupra căreia vrei să acționezi, apoi mergi la Configurare → Chei API din bara laterală și creează o cheie de companie. Alege ce servicii poate apela cheia - fiecare trebuie să fie activ pe companie (eFactura, Extrase, Info CUI, Schimb valutar).
7. Send both keys on every request Pass the org key as X-Org-Key and the company key as X-Api-Key.
8. Trimite ambele chei la fiecare cerere Trimite cheia de organizație ca X-Org-Key și cheia de companie ca X-Api-Key.

Your first callPrimul apel

Look up a Romanian company by its CUI:

Caută o companie românească după CUI:

curl -sS 'https://api.fint.ro/v1/infocui?cui=12345678' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

A successful response returns the company data envelope:

Un răspuns reușit returnează envelopa cu datele companiei:

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "cui": "12345678",
    "name": "Exemplu SRL",
    "registrationNumber": "J40/1234/2010",
    "vatRegistered": true
  }
}

Next: read Authentication for key scoping and error codes, then explore the service references.

Urmează: citește Autentificare pentru domeniul cheilor și codurile de eroare, apoi explorează referințele serviciilor.

AuthenticationAutentificare

Fint uses dual-key authentication: an organization key plus a company key, sent on every request.

Fint folosește autentificare cu două chei: o cheie de organizație plus o cheie de companie, trimise la fiecare cerere.

Required headersHeader-e obligatorii

Alternatively, the company key may be sent as Authorization: Bearer <company_key>; the org key must still be sent as X-Org-Key.

Alternativ, cheia de companie poate fi trimisă ca Authorization: Bearer <company_key>; cheia de organizație trebuie trimisă tot ca X-Org-Key.

curl -sS 'https://api.fint.ro/v1/extrase/accounts' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

Key scopingDomeniul cheilor

Two key types work together:

Două tipuri de chei lucrează împreună:

• Organization key: one per organization, created under User menu → API → Chei API. Identifies the organization; it has no per-service scope.
• Cheie de organizație: una per organizație, creată în Meniu utilizator → API → Chei API. Identifică organizația; nu are domeniu per serviciu.
• Company key: one per company, created under Configurare → Chei API in the sidebar for the active company. Selects which company the request acts on and which services the key may call.
• Cheie de companie: una per companie, creată în Configurare → Chei API din bara laterală, pentru compania activă. Selectează compania asupra căreia acționează cererea și serviciile pe care cheia le poate apela.

Company keys carry a services set (efactura, extrase, infocui, schimbvalutar) enforced at runtime. In addition, the company’s license must have the called service activated.

Cheile de companie poartă un set services (efactura, extrase, infocui, schimbvalutar) aplicat la runtime. În plus, licența companiei trebuie să aibă serviciul apelat activat.

Authentication errorsErori de autentificare

All errors use status: "error" with a human-readable msg and a stable reason. Branch on reason.

Toate erorile folosesc status: "error" cu un msg lizibil și un reason stabil. Ramifică pe reason.

Extrase

PSD2 open-banking accounts and transactions, already synchronized from connected banks. Reads return stored Fint data only.

Conturi și tranzacții PSD2 open banking, deja sincronizate din băncile conectate. Citirile returnează doar datele stocate în Fint.

ConsentConsimțământ

An Extrase consent is a PSD2 authorization for Fint to read a company’s bank accounts and transactions at a specific bank. It is established when an authorized person completes the bank’s OAuth flow in Fint’s open-banking onboarding. The consent is recorded with status and a validUntil date on your company license, and Fint keeps accounts, balances, and transactions synchronized for you to read. Each connected bank requires its own consent.

Un consimțământ Extrase este o autorizare PSD2 pentru ca Fint să citească conturile bancare și tranzacțiile unei companii la o anumită bancă. Se stabilește când o persoană autorizată finalizează fluxul OAuth al băncii în onboarding-ul open banking Fint. Consimțământul este înregistrat cu status și o dată validUntil pe licența companiei tale, iar Fint menține conturile, soldurile și tranzacțiile sincronizate pentru a fi citite. Fiecare bancă conectată necesită propriul consimțământ.

You can obtain consent in three ways:

Poți obține consimțământul în trei moduri:

• Fint UI: sign in to Fint, go to Extrase → Conturi, pick a bank, and complete the bank authorization flow.
• Interfața Fint: autentifică-te în Fint, mergi la Extrase → Conturi, alege o bancă și finalizează fluxul de autorizare bancară.
• Share link (delegated): from the Fint UI, generate a 7-day onboarding link and send it to someone who can authorize at the bank; they complete the browser flow for your company license.
• Link de partajare (delegat): din interfața Fint, generează un link de onboarding valabil 7 zile și trimite-l cuiva care poate autoriza la bancă; acea persoană finalizează fluxul în browser pentru licența companiei tale.
• API (self-service): call /onboarding to generate a share link, have the authorized person open it in a browser and complete bank authorization, then poll /consents until the target bank shows consentStatus: enabled. See Onboarding & consentOnboarding și consimțământ below.
• API (self-service): apelează /onboarding pentru a genera un link de partajare, lasă persoana autorizată să-l deschidă în browser și să finalizeze autorizarea bancară, apoi interoghează /consents până când banca țintă afișează consentStatus: enabled. Vezi Onboarding & consentOnboarding și consimțământ mai jos.

The bank authorization step can be completed only by a person who can authenticate with that bank as the PSU (payment service user) for the accounts being connected. Steps vary by bank: OAuth redirect, internet banking app approval, or manual confirmation after PSU ID or IBAN collection where required. Fint does not collect or store internet banking passwords, PINs, or OTP/token codes.

Pasul de autorizare bancară poate fi finalizat doar de o persoană care se poate autentifica la banca respectivă ca PSU (utilizator de servicii de plată) pentru conturile conectate. Pașii variază în funcție de bancă: redirect OAuth, aprobare în aplicația de internet banking sau confirmare manuală după colectarea ID-ului PSU sau IBAN-ului, unde este necesar. Fint nu colectează și nu stochează parole de internet banking, PIN-uri sau coduri OTP/token.

The public API reads stored data only; it does not create consents or call the bank. /accounts returns stored accounts even from disabled consents (see consentStatus and consentValidUntil on each account). /transactions and /transaction/{uid} include data from enabled consents only. Without enabled consents, API calls succeed but return empty transaction data.

API-ul public citește doar date stocate; nu creează consimțăminte și nu apelează banca. /accounts returnează conturi stocate chiar și din consimțăminte dezactivate (vezi consentStatus și consentValidUntil pe fiecare cont). /transactions și /transaction/{uid} includ date doar din consimțăminte activate. Fără consimțăminte activate, apelurile API reușesc dar returnează date de tranzacții goale.

Onboarding & consentOnboarding și consimțământ

API-only flow for delegated bank authorization: generate a share link with /onboarding, have the authorized person complete the bank’s OAuth flow, then poll /consents until the target bank’s entry shows consentStatus: enabled.

Flux doar prin API pentru autorizare bancară delegată: generează un link de partajare cu /onboarding, lasă persoana autorizată să finalizeze fluxul OAuth al băncii, apoi interoghează /consents până când înregistrarea băncii țintă afișează consentStatus: enabled.

Create onboarding linkCreează link de onboarding

Creates a 7-day share link the end-user opens in a browser to connect a bank account. The link opens Fint’s bank-selection and OAuth consent flow.

Creează un link de partajare valabil 7 zile pe care utilizatorul final îl deschide în browser pentru a conecta un cont bancar. Link-ul deschide fluxul de selecție a băncii și consimțământul OAuth Fint.

Example requestExemplu de cerere

curl -sS -X POST 'https://api.fint.ro/v1/extrase/onboarding' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'

ResponseRăspuns

{
  "status": "success",
  "data": {
    "authLink": "https://app.fint.ro/onboarding/extrase?token=...",
    "expiresOn": "2026-07-04 08:00:00"
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Check consentsVerifică consimțămintele

Returns all bank consents for the company key’s license - one entry per bank (de-duplicated, latest first). Returns an empty list when no consents exist. This is a GET endpoint and takes no request body.

Returnează toate consimțămintele bancare pentru licența cheii de companie - o intrare per bancă (deduplicat, cel mai recent primul). Returnează o listă goală când nu există consimțăminte. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/extrase/consents' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

Response (consents present)Răspuns (consimțăminte prezente)

{
  "status": "success",
  "data": {
    "consents": [
      {
        "bankCode": "BCR",
        "bankName": "BCR Bank",
        "consentStatus": "enabled",
        "validUntil": "2026-09-01 00:00:00",
        "updatedOn": "2026-06-01 12:00:00"
      }
    ],
    "total": 1
  }
}

Response (no consents)Răspuns (fără consimțăminte)

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "consents": [],
    "total": 0
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

List accountsListează conturi

Returns all stored accounts for the company key’s license, including accounts from disabled consents. The account uid is the public identifier. This is a GET endpoint and takes no request body.

Returnează toate conturile stocate pentru licența cheii de companie, inclusiv conturi din consimțăminte dezactivate. uid contului este identificatorul public. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/extrase/accounts' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "accounts": [
      {
        "uid": "a1b2c3d4e5f64789a0123456789abcde",
        "status": "enabled",
        "iban": "RO49RNCB0000000000000001",
        "currency": "RON",
        "balance": "123.45",
        "name": "Cont curent",
        "ownerName": "Exemplu SRL",
        "product": "Current Account",
        "cashAccountType": "CACC",
        "bic": "RNCBROBU",
        "bank": {
          "code": "BCR",
          "name": "BCR Bank",
          "bic": "RNCB",
          "icon": "https://cdn.fint.ro/image/bank/icon/bcr.png"
        },
        "consentStatus": "enabled",
        "consentValidUntil": "2026-12-31",
        "lastTransactionsSync": "2026-06-22 08:00:00",
        "createdOn": "2026-06-01 10:00:00",
        "updatedOn": "2026-06-22 08:00:00"
      }
    ],
    "total": 1
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

List transactionsListează tranzacții

Transactions are scoped to enabled Extrase consents for the matched company. Results are newest-first and offset-paginated. This is a GET endpoint and takes no request body; pass parameters in the query string.

Tranzacțiile sunt limitate la consimțămintele Extrase activate pentru compania potrivită. Rezultatele sunt ordonate de la cele mai recente și paginate prin offset. Este un endpoint GET și nu primește corp de cerere; trimite parametrii în query string.

Each item in transactions[] is a full transaction object - the same per-field structure returned by Get a transaction, including the optional provider fields (each present only when the bank/provider supplied it). The envelope also carries total, limit and offset for pagination.

Fiecare element din transactions[] este un obiect tranzacție complet - aceeași structură pe câmpuri returnată de Obține o tranzacție, inclusiv câmpurile opționale de la furnizor (fiecare prezent doar când banca/furnizorul l-a furnizat). Envelopa conține și total, limit și offset pentru paginare.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/extrase/transactions?limit=50&offset=0&type=incoming' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "transactions": [
      {
        "uid": "Qf4x...",
        "type": "incoming",
        "bookingDate": "2026-06-21 00:00:00",
        "executionDateTime": "2026-06-21 09:14:32",
        "entryReference": "ENTRY-12345",
        "endToEndId": "E2E-55512",
        "interlocutor": "Client SRL",
        "interlocutorIban": "RO49AAAA1B31007593840000",
        "amount": "100.00",
        "currency": "RON",
        "fintDescription": "Payment details",
        "rawDescription": "Original bank remittance text",
        "category": "Comisioane si Taxe",
        "creditorName": "Cont curent",
        "creditorAccountIban": "RO49RNCB0000000000000001",
        "debtorName": "Client SRL",
        "debtorAccountIban": "RO49AAAA1B31007593840000",
        "transactionStatus": "booked",
        "userNote": "",
        "createdOn": "2026-06-22 08:00:00",
        "accountUid": "a1b2c3d4e5f64789a0123456789abcde",
        "accountIban": "RO49RNCB0000000000000001",
        "accountName": "Cont curent",
        "bank": {
          "code": "BCR",
          "name": "BCR Bank",
          "bic": "RNCB",
          "icon": "https://cdn.fint.ro/image/bank/icon/bcr.png"
        }
      }
    ],
    "total": 42,
    "limit": 50,
    "offset": 0
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Get a transactionObține o tranzacție

Returns one transaction owned by the company key’s license under an enabled consent. The response includes the summary fields plus the optional provider fields listed below - the same per-transaction structure returned by List transactions. This is a GET endpoint and takes no request body.

Returnează o tranzacție deținută de licența cheii de companie sub un consimțământ activ. Răspunsul include câmpurile sumare plus câmpurile opționale de la furnizor listate mai jos - aceeași structură per tranzacție returnată de Listează tranzacții. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/extrase/transaction/Qf4x...' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "uid": "Qf4x...",
    "type": "incoming",
    "bookingDate": "2026-06-21 00:00:00",
    "executionDateTime": "2026-06-21 09:14:32",
    "entryReference": "ENTRY-12345",
    "endToEndId": "E2E-55512",
    "interlocutor": "Client SRL",
    "interlocutorIban": "RO49AAAA1B31007593840000",
    "amount": "100.00",
    "currency": "RON",
    "fintDescription": "Payment details",
    "rawDescription": "Original bank remittance text",
    "category": "Comisioane si Taxe",
    "userNote": "",
    "createdOn": "2026-06-22 08:00:00",
    "accountUid": "a1b2c3d4e5f64789a0123456789abcde",
    "accountIban": "RO49RNCB0000000000000001",
    "accountName": "Cont curent",
    "bank": {
      "code": "BCR",
      "name": "BCR Bank",
      "bic": "RNCB",
      "icon": "https://cdn.fint.ro/image/bank/icon/bcr.png"
    },
    "suggestedReconciliation": []
  }
}

Response fieldsCâmpuri de răspuns

Optional provider fields - returned by both this endpoint and List transactions, in addition to the fields above, and only when the bank/provider supplied them.

Câmpuri opționale de la furnizor - returnate atât de acest endpoint, cât și de Listează tranzacții, pe lângă câmpurile de mai sus, și numai când banca/furnizorul le-a furnizat.

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Reconciliation suggestionsSugestii de reconciliere

Every transaction returned by List transactions and Get a transaction carries suggestedReconciliation: the e-invoices this payment most likely settles, each with a confidence score from 1 to 100.

Fiecare tranzacție returnată de Listează tranzacții și Obține o tranzacție conține suggestedReconciliation: facturile electronice pe care această plată le achită cel mai probabil, fiecare cu un scor de încredere de la 1 la 100.

ExampleExemplu

"suggestedReconciliation": [
  {
    "documentUid": "d1b2c3...",
    "documentType": "outgoing",
    "documentNumber": "INS2874",
    "documentDate": "2026-06-15",
    "documentDueDate": "2026-07-15",
    "documentTotal": "20570.00",
    "documentCurrency": "RON",
    "counterparty": "Client SRL",
    "counterpartyCui": "RO12345678",
    "confidence": 100
  }
]

Entry fieldsCâmpurile unei intrări

Three distinct valuesTrei valori distincte

Two candidates for the same payment is normal and is not an error. When two invoices to the same client share a total, both are returned with their own confidence and Fint does not pick one - the gap between the scores is the signal. Suggestions are rebuilt hourly, so a transaction imported minutes ago may not have one yet.

Doi candidați pentru aceeași plată este normal și nu este o eroare. Când două facturi către același client au același total, ambele sunt returnate cu propriul scor, iar Fint nu alege una - diferența dintre scoruri este semnalul. Sugestiile sunt recalculate orar, deci o tranzacție importată acum câteva minute poate să nu aibă încă una.

The mirror view - which payment settles a given invoice - is on the eFactura page.

Vederea în oglindă - ce plată achită o anumită factură - se află pe pagina eFactura.

eFactura

Submit outgoing Romanian e-invoices and manage incoming and outgoing documents. Fint handles delivery to ANAF e-Factura.

Trimite facturi electronice românești de ieșire și gestionează documente de intrare și ieșire. Fint se ocupă de transmiterea către ANAF e-Factura.

ConsentConsimțământ

An eFactura consent is the company’s authorization for Fint to access ANAF e-Factura on its behalf. It is established through ANAF’s OAuth flow: the authorized person grants access at ANAF, and the consent is recorded for the company license with a CUI and a validUntil date. While the consent is enabled, Fint can submit outgoing documents, report their status, and provide incoming documents from ANAF for that CUI.

Un consimțământ eFactura este autorizarea companiei pentru ca Fint să acceseze ANAF e-Factura în numele ei. Se stabilește prin fluxul OAuth ANAF: persoana autorizată acordă acces la ANAF, iar consimțământul este înregistrat pe licența companiei cu un CUI și o dată validUntil. Cât timp consimțământul este activ, Fint poate trimite documente de ieșire, raporta statusul lor și furniza documente de intrare de la ANAF pentru acel CUI.

You can obtain consent in two ways:

Poți obține consimțământul în două moduri:

• Fint UI: sign in to Fint, go to Configurare → Servicii, and complete the eFactura authorization flow for the company.
• Interfața Fint: autentifică-te în Fint, mergi la Configurare → Servicii și finalizează fluxul de autorizare eFactura pentru companie.
• API (self-service): call /onboarding to generate a share link, have the authorized person open it in a browser and complete ANAF authorization, then poll /consent until data.consentStatus is enabled. See Onboarding & consentOnboarding și consimțământ below.
• API (self-service): apelează /onboarding pentru a genera un link de partajare, lasă persoana autorizată să-l deschidă în browser și să finalizeze autorizarea ANAF, apoi interoghează /consent până când data.consentStatus este enabled. Vezi Onboarding & consentOnboarding și consimțământ mai jos.

The ANAF authorization step can be completed only by a person who holds a qualified digital certificate registered at ANAF for the company’s CUI (fiscal code). That person must authenticate at ANAF with that certificate; Fint does not collect or store certificate passwords, PINs, or other signing credentials. The company must also have active e-Factura access in ANAF SPV (Spatiu Privat Virtual).

Pasul de autorizare ANAF poate fi finalizat doar de o persoană care deține un certificat digital calificat înregistrat la ANAF pentru CUI-ul (codul fiscal) companiei. Acea persoană trebuie să se autentifice la ANAF cu certificatul respectiv; Fint nu colectează și nu stochează parole de certificat, PIN-uri sau alte credențiale de semnare. Compania trebuie să aibă și acces activ e-Factura în ANAF SPV (Spațiu Privat Virtual).

For outgoing documents, the consent CUI must match from.cui on each /send request. Without an enabled consent, /send returns 403 efactura_consent_required.

Pentru documente de ieșire, CUI-ul consimțământului trebuie să coincidă cu from.cui la fiecare cerere /send. Fără consimțământ activ, /send returnează 403 efactura_consent_required.

Onboarding & consentOnboarding și consimțământ

API-only flow for delegated ANAF authorization: generate a share link with /onboarding, have the certificate holder complete authorization at ANAF, then poll /consent until consent is enabled.

Flux doar prin API pentru autorizare ANAF delegată: generează un link de partajare cu /onboarding, lasă titularul certificatului să finalizeze autorizarea la ANAF, apoi interoghează /consent până când consimțământul este activ.

Create onboarding linkCreează link de onboarding

Creates a 7-day share link the end-user opens in a browser to authorize Fint at ANAF.

Creează un link de partajare valabil 7 zile pe care utilizatorul final îl deschide în browser pentru a autoriza Fint la ANAF.

Example requestExemplu de cerere

curl -sS -X POST 'https://api.fint.ro/v1/efactura/onboarding' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'

ResponseRăspuns

{
  "status": "success",
  "data": {
    "authLink": "https://app.fint.ro/onboarding/efactura?token=...",
    "expiresOn": "2026-06-27 12:00:00"
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Check consentVerifică consimțământul

Returns the enabled ANAF consent for the company key’s license, or data: null when none is enabled yet. This is a GET endpoint and takes no request body.

Returnează consimțământul ANAF activ pentru licența cheii de companie, sau data: null când niciunul nu este încă activ. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/efactura/consent' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

Response (consent enabled)Răspuns (consimțământ activ)

{
  "status": "success",
  "data": {
    "consentStatus": "enabled",
    "validUntil": "2027-01-01",
    "updatedOn": "2026-06-01 10:00:00"
  }
}

Response (no enabled consent)Răspuns (fără consimțământ activ)

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": null
}

Response fieldsCâmpuri de răspuns

data is null when no ANAF consent is enabled yet. When a consent is enabled, data is an object with the fields below.

data este null când niciun consimțământ ANAF nu este încă activ. Când un consimțământ este activ, data este un obiect cu câmpurile de mai jos.

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Send a documentTrimite un document

Validates and enqueues one outgoing document. The request body is a single JSON object describing the invoice; the fields below are its top-level keys (not HTTP headers). Fint maps it to a CIUS-RO (EN 16931) UBL invoice before sending it to ANAF.

Validează și pune în coadă un document de ieșire. Corpul cererii este un singur obiect JSON care descrie factura; câmpurile de mai jos sunt cheile sale de nivel superior (nu header-e HTTP). Fint îl transformă într-o factură UBL CIUS-RO (EN 16931) înainte de a o trimite la ANAF.

Request body fieldsCâmpuri din corpul cererii

HeaderAntet

Parties - from & toPărți - from și to

from is the supplier (furnizor) and to is the customer (client). Both share the same shape. from.cui must equal the enabled consent CUI for your license, otherwise 422 from_cui_mismatch. For a consumer (B2C) buyer, set to.cui to 0000000000000; a full to.name and to.address are still required.

from este furnizorul și to este clientul. Ambele au aceeași structură. from.cui trebuie să fie egal cu CUI-ul consimțământului activ al licenței, altfel 422 from_cui_mismatch. Pentru un client persoană fizică (B2C), setează to.cui la 0000000000000; sunt necesare în continuare to.name și to.address complete.

Normalization. You do not need to pre-format addresses. Fint accepts county names or codes (e.g. Cluj or RO-CJ) and Bucharest variants (București, Sector 1, RO-B) and normalizes them to ANAF/CIUS-RO form; unrecognized city/subdivision is filled from Info CUI by the party’s cui.

Normalizare. Nu trebuie să pre-formatezi adresele. Fint acceptă nume sau coduri de județ (ex. Cluj sau RO-CJ) și variante pentru București (București, Sector 1, RO-B) și le normalizează în forma ANAF/CIUS-RO; localitatea/subdiviziunea nerecunoscută este completată din Info CUI după cui-ul părții.

Trade register number. The same Info CUI lookup fills from.regCom when you leave the key out of the payload, so the seller’s nr. reg. com. reaches ANAF without any work on your side. Send from.regCom yourself to override it, or send it as "" / null to omit it from the invoice. There is no auto-fill for to.regCom - send it if you want the buyer’s number on the document.

Numărul de la registrul comerțului. Aceeași căutare în Info CUI completează from.regCom când nu trimiți deloc cheia, așa că nr. reg. com. al vânzătorului ajunge la ANAF fără efort din partea ta. Trimite from.regCom pentru a-l suprascrie, sau trimite-l ca "" / null pentru a-l omite din factură. Pentru to.regCom nu există completare automată - trimite-l dacă vrei numărul cumpărătorului pe document.

Line items - items[]Linii - items[]

A non-empty array; each element is one invoice line.

Un array nevid; fiecare element este o linie de factură.

VAT schemes (vatScheme)Scheme de TVA (vatScheme)

The per-item vatScheme is a UNCL 5305 category code. Every scheme except S is a zero-rate category and requires vatRate: 0. The API validates vatScheme and the vatRate: 0 coupling; the vatexCode and deliveryDate requirements in the "Requires" column are enforced by ANAF at submission, not pre-checked by this API.

Câmpul vatScheme per articol este un cod de categorie UNCL 5305. Orice schemă în afară de S este o categorie cu cotă zero și necesită vatRate: 0. API-ul validează vatScheme și corelarea cu vatRate: 0; cerințele vatexCode și deliveryDate din coloana "Necesită" sunt aplicate de ANAF la trimitere, nu pre-verificate de acest API.

Payment - paymentMeansPlată - paymentMeans

The paymentMeans object is optional. When you include it, paymentMeansCode is required within it.

Obiectul paymentMeans este opțional. Când îl incluzi, paymentMeansCode este obligatoriu în interiorul lui.

curl -sS -X POST 'https://api.fint.ro/v1/efactura/send' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "documentNumber": "INV-1",
    "documentDate": "2025-03-21",
    "currency": "RON",
    "documentTypeCode": "380",
    "note": "Livrare conform contract 42/2025.",
    "deliveryDate": "2025-03-21",
    "from": {
      "cui": "34790982",
      "name": "Seller SRL",
      "address": {
        "line": "Str. Test 1",
        "city": "SECTOR1",
        "postalCode": "010001",
        "countrySubdivision": "RO-B",
        "country": "RO"
      },
      "regCom": "J40/12813/2016"
    },
    "to": {
      "cui": "12345678",
      "name": "Buyer SRL",
      "address": {
        "line": "Str. Client 2",
        "city": "SECTOR1",
        "postalCode": "010002",
        "countrySubdivision": "RO-B",
        "country": "RO"
      },
      "regCom": "J40/8853/2015"
    },
    "items": [
      {
        "name": "Service",
        "quantity": 1,
        "price": 100,
        "vatRate": 21,
        "vatScheme": "S",
        "classificationCode": "79411000",
        "classificationList": "STI"
      }
    ],
    "paymentMeans": {
      "paymentMeansCode": "30",
      "iban": "RO49AAAA1B31007593840000",
      "paymentId": "ORD-1"
    }
  }'

{
  "documentNumber": "INV-1",
  "documentDate": "2025-03-21",
  "currency": "RON",
  "documentTypeCode": "380",
  "note": "Livrare conform contract 42/2025.",
  "deliveryDate": "2025-03-21",
  "from": {
    "cui": "34790982",
    "name": "Seller SRL",
    "address": {
      "line": "Str. Test 1",
      "city": "SECTOR1",
      "postalCode": "010001",
      "countrySubdivision": "RO-B",
      "country": "RO"
    },
    "regCom": "J40/12813/2016"
  },
  "to": {
    "cui": "12345678",
    "name": "Buyer SRL",
    "address": {
      "line": "Str. Client 2",
      "city": "SECTOR1",
      "postalCode": "010002",
      "countrySubdivision": "RO-B",
      "country": "RO"
    },
    "regCom": "J40/8853/2015"
  },
  "items": [
    {
      "name": "Service",
      "quantity": 1,
      "price": 100,
      "vatRate": 21,
      "vatScheme": "S",
      "classificationCode": "79411000",
      "classificationList": "STI"
    }
  ],
  "paymentMeans": {
    "paymentMeansCode": "30",
    "iban": "RO49AAAA1B31007593840000",
    "paymentId": "ORD-1"
  }
}

In short, documentNumber, documentDate, currency (RON), from, to, and a non-empty items array are required; everything else is optional. After local checks and a duplicate check, Fint pre-validates the generated UBL with ANAF.

Pe scurt, documentNumber, documentDate, currency (RON), from, to și un array items nevid sunt obligatorii; restul sunt opționale. După verificări locale și verificarea duplicatelor, Fint pre-validează UBL-ul generat cu ANAF.

Response (201 Created)Răspuns (201 Created)

{
  "status": "success",
  "msg": "Document has been validated with Fint. Pending upload and ANAF confirmation.",
  "reason": null,
  "data": {
    "uid": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
    "status": "pending"
  }
}

Response fieldsCâmpuri de răspuns

On failure, data instead carries error detail: a 422 validation_failed returns a data.errors[] array (each with code, field, message), and a 409 duplicate_document returns data.existingDocumentUid.

La eșec, data conține în schimb detaliul erorii: un 422 validation_failed returnează un array data.errors[] (fiecare cu code, field, message), iar un 409 duplicate_document returnează data.existingDocumentUid.

Response (422 validation failed)Răspuns (422 validare eșuată)

{
  "status": "error",
  "msg": "Document is not valid.",
  "reason": "validation_failed",
  "data": {
    "errors": [
      {
        "code": "from_cui_mismatch",
        "field": "from.cui",
        "message": "from.cui must match the enabled eFactura consent CUI for this license"
      }
    ]
  }
}

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

List documentsListează documente

Lists documents for the key’s license. No query parameters uses defaults. Omitting type returns both directions (incoming and outgoing) interleaved, newest-first; each item carries a type field so you can tell them apart. For line items and download availability, use /document. This is a GET endpoint and takes no request body; pass parameters in the query string.

Listează documentele pentru licența cheii. Fără parametri de query folosește valorile implicite. Fără type sunt returnate ambele direcții (intrare și ieșire) intercalate, cele mai noi primele; fiecare element are un câmp type ca să le poți deosebi. Pentru linii și disponibilitate descărcare, folosește /document. Este un endpoint GET și nu primește corp de cerere; trimite parametrii în query string.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/efactura/documents?type=incoming&limit=50&offset=0' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "documents": [
      {
        "uid": "a1b2c3d4-...",
        "type": "incoming",
        "status": "validated",
        "source": "spv",
        "documentTypeCode": "380",
        "documentNumber": "INV-1",
        "documentDate": "2025-03-21",
        "currency": "RON",
        "fromTo": "Seller SRL",
        "fromToCui": "34790982",
        "total": "121.00",
        "anafStatus": "ok",
        "anafId": "5032836579",
        "processed": 1,
        "createdOn": "2025-03-21 10:00:00",
        "updatedOn": "2025-03-21 12:00:00"
      }
    ],
    "total": 42,
    "limit": 50,
    "offset": 0
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Get a documentObține un document

Resolves any document (outgoing or incoming) owned by the company key’s license, including parties, line items, payment means, ANAF state and download availability. This is a GET endpoint and takes no request body.

Rezolvă orice document (de ieșire sau intrare) deținut de licența cheii de companie, inclusiv părți, linii, mijloace de plată, starea ANAF și disponibilitatea descărcării. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/efactura/document/a1b2c3d4-e5f6-4789-a012-3456789abcde' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

ResponseRăspuns

{
  "status": "success",
  "data": {
    "uid": "a1b2c3d4-...",
    "type": "outgoing",
    "status": "validated",
    "errorMessage": null,
    "source": "fint",
    "documentTypeCode": "380",
    "documentNumber": "INV-1",
    "documentDate": "2025-03-21",
    "currency": "RON",
    "fromTo": "Buyer SRL",
    "fromToCui": "12345678",
    "total": "100.00",
    "anafStatus": "ok",
    "anafId": "5032836579",
    "pdfAvailable": 1,
    "xmlAvailable": 1,
    "processed": 1,
    "createdOn": "2025-03-21 10:00:00",
    "updatedOn": "2025-03-21 12:00:00",
    "note": "Livrare conform contract 42/2025.",
    "dueDate": "2025-04-20",
    "buyerReference": "PO-2025-042",
    "deliveryDate": "2025-03-21",
    "deliveryAddress": null,
    "from": {
      "cui": "34790982",
      "name": "Seller SRL",
      "address": {
        "line": "Str. Test 1",
        "city": "SECTOR1",
        "postalCode": "010001",
        "countrySubdivision": "RO-B",
        "country": "RO"
      },
      "regCom": "J40/12813/2016"
    },
    "to": {
      "cui": "12345678",
      "name": "Buyer SRL",
      "address": {
        "line": "Str. Client 2",
        "city": "SECTOR1",
        "postalCode": "010002",
        "countrySubdivision": "RO-B",
        "country": "RO"
      },
      "regCom": "J40/8853/2015"
    },
    "items": [
      {
        "name": "Service",
        "quantity": 1,
        "price": 100,
        "vatRate": 0,
        "vatScheme": "E",
        "currency": "RON",
        "vatexCode": "VATEX-EU-D",
        "vatexReason": "Scutit conform reglementarilor UE",
        "classificationCode": "79411000",
        "classificationList": "STI",
        "value": "100.00"
      }
    ],
    "paymentMeans": {
      "paymentMeansCode": "30",
      "paymentId": "ORD-1",
      "iban": "RO49AAAA1B31007593840000",
      "accountName": "Main account",
      "bic": null
    },
    "suggestedReconciliation": []
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Download a documentDescarcă un document

Returns the raw binary as an attachment, not the JSON envelope. PDF for type=pdf; signed XML delivered as a ZIP for type=xml (zip is an alias for xml). Use pdfAvailable/xmlAvailable from /document/{uid} to know which exist. This is a GET endpoint and takes no request body.

Returnează binarul brut ca atașament, nu envelopa JSON. PDF pentru type=pdf; XML semnat livrat ca ZIP pentru type=xml (zip este alias pentru xml). Folosește pdfAvailable/xmlAvailable din /document/{uid} pentru a ști ce există. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/efactura/download/a1b2c3d4-e5f6-4789-a012-3456789abcde?type=pdf' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY' \
  -o document.pdf

Response (200 OK)Răspuns (200 OK)

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

UBL mappingMapare UBL

Fint maps the document to a CIUS-RO (EN 16931) UBL invoice before sending it to ANAF. You do not need any of this to use the API - it is a reference for reconciling Fint fields against a raw UBL/XML invoice or the ANAF PDF. Seller and buyer share the same element paths - regCom is the one exception - and the EN 16931 column shows seller / buyer where they differ.

Fint mapează documentul într-o factură UBL CIUS-RO (EN 16931) înainte de a o trimite la ANAF. Nu ai nevoie de aceste detalii pentru a folosi API-ul - sunt o referință pentru a reconcilia câmpurile Fint cu o factură UBL/XML brută sau cu PDF-ul ANAF. Furnizorul și clientul folosesc aceleași căi de element - regCom este singura excepție - iar coloana EN 16931 arată furnizor / client acolo unde diferă.

vatexCode / vatexReason are emitted once per VAT category in the document VAT breakdown, not on each line (CIUS-RO). All totals and the VAT breakdown are computed by Fint from items - they are not sent.

vatexCode / vatexReason sunt emise o singură dată per categorie de TVA în detalierea TVA a documentului, nu pe fiecare linie (CIUS-RO). Toate totalurile și detalierea TVA sunt calculate de Fint din items - nu se trimit.

Reconciliation suggestionsSugestii de reconciliere

Every document returned by List documents and Get a document carries suggestedReconciliation: the bank payments that most likely settle this invoice, each with a confidence score from 1 to 100. It is the mirror of the same field on the Extrase transaction endpoints.

Fiecare document returnat de Listează documente și Obține un document conține suggestedReconciliation: plățile bancare care achită cel mai probabil această factură, fiecare cu un scor de încredere de la 1 la 100. Este oglinda aceluiași câmp de pe endpoint-urile de tranzacții Extrase.

ExampleExemplu

"suggestedReconciliation": [
  {
    "transactionUid": "Qf4x...",
    "transactionType": "incoming",
    "bookingDate": "2026-07-13 00:00:00",
    "amount": "20570.00",
    "currency": "RON",
    "interlocutor": "Client SRL",
    "interlocutorIban": "RO09PORL7789778256833565",
    "accountUid": "a1b2c3d4e5f64789a0123456789abcde",
    "accountIban": "RO49RNCB0000000000000001",
    "bankName": "BCR Bank",
    "confidence": 100
  }
]

Entry fieldsCâmpurile unei intrări

Three distinct valuesTrei valori distincte

Two candidates for the same invoice is normal and is not an error. Fint reports every plausible payment with its own confidence and never picks one - the gap between the scores is the signal. Suggestions are rebuilt hourly, so a document synced minutes ago may not have one yet.

Doi candidați pentru aceeași factură este normal și nu este o eroare. Fint raportează fiecare plată plauzibilă cu propriul scor și nu alege niciodată una - diferența dintre scoruri este semnalul. Sugestiile sunt recalculate orar, deci un document sincronizat acum câteva minute poate să nu aibă încă una.

Info CUI

Look up Romanian company data by CUI (fiscal code): identity, VAT status and financial history (balance sheet). Responses are cached permanently.

Caută date despre companii românești după CUI (cod fiscal): identificare, stare TVA și istoric financiar (bilanț). Răspunsurile sunt cache-uite permanent.

Look up a companyCaută o companie

Pass the company to look up as the required cui query parameter (string or integer; RO prefix stripped, digits only); any valid Romanian CUI is allowed. Dual-key auth still applies. This is a GET endpoint and takes no request body.

Trimite compania de căutat ca parametru query obligatoriu cui (string sau întreg; prefixul RO eliminat, doar cifre); orice CUI românesc valid este permis. Autentificarea cu două chei se aplică în continuare. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/infocui?cui=12345678' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "cui": "12345678",
    "name": "Exemplu SRL",
    "registrationNumber": "J40/1234/2010",
    "address": "Str. Exemplu 1",
    "addressFull": "Str. Exemplu 1, București, Sector 3",
    "city": "București",
    "county": "Sector 3",
    "countyCode": "B",
    "country": "România",
    "postalCode": "010101",
    "phone": null,
    "fax": null,
    "iban": null,
    "registrationStatus": "INREGISTRAT din data 01.01.2010",
    "registrationDate": "2010-01-01",
    "caenCode": "6201",
    "eInvoiceEnabled": false,
    "taxAuthority": "Administrația Finanțelor Publice",
    "legalForm": "SOCIETATE COMERCIALĂ CU RĂSPUNDERE LIMITATĂ",
    "vatRegistered": true,
    "cashVatEnabled": false,
    "financials": {
      "currency": "RON",
      "latestYear": 2024,
      "years": [
        {
          "year": 2024,
          "caenCode": "6201",
          "caenCode_label": "Cod CAEN",
          "employees": 21,
          "employees_label": "Număr mediu de salariați",
          "netTurnover": 4163901,
          "netTurnover_label": "Cifra de afaceri netă",
          "totalRevenue": 4225683,
          "totalRevenue_label": "Venituri totale",
          "totalExpenses": 3701679,
          "totalExpenses_label": "Cheltuieli totale",
          "grossProfit": 524004,
          "grossProfit_label": "Profit brut",
          "grossLoss": 0,
          "grossLoss_label": "Pierdere brută",
          "netProfit": 415548,
          "netProfit_label": "Profit net",
          "netLoss": 0,
          "netLoss_label": "Pierdere netă",
          "fixedAssets": 281078,
          "fixedAssets_label": "Active imobilizate",
          "currentAssets": 2219841,
          "currentAssets_label": "Active circulante",
          "inventory": 177271,
          "inventory_label": "Stocuri",
          "receivables": 152070,
          "receivables_label": "Creanțe",
          "cash": 1890500,
          "cash_label": "Casa și conturi la bănci",
          "prepaidExpenses": 0,
          "prepaidExpenses_label": "Cheltuieli în avans",
          "liabilities": 1608209,
          "liabilities_label": "Datorii",
          "deferredRevenue": 125715,
          "deferredRevenue_label": "Venituri în avans",
          "provisions": 0,
          "provisions_label": "Provizioane",
          "equity": 766995,
          "equity_label": "Capitaluri total",
          "paidCapital": 322,
          "paidCapital_label": "Capital subscris vărsat",
          "publicPatrimony": 0,
          "publicPatrimony_label": "Patrimoniul regiei"
        }
      ]
    }
  }
}

Response fieldsCâmpuri de răspuns

Financials. The financials object carries the company’s balance-sheet history from ANAF filings: currency, latestYear and years (newest first, typically from 2013 onward). Amounts are whole-RON integers; employees is the average headcount. Every field except year has a sibling <field>_label with the official ANAF Romanian term (e.g. netTurnover_label = Cifra de afaceri netă). A company with no filed balance sheet returns an empty years array with latestYear null. Financials are included in the same request at no extra cost.

Date financiare. Obiectul financials conține istoricul bilanțier al companiei din declarațiile ANAF: currency, latestYear și years (de la cel mai recent, de regulă din 2013). Sumele sunt numere întregi în RON; employees este numărul mediu de salariați. Fiecare câmp în afară de year are un câmp pereche <field>_label cu termenul oficial ANAF în română (ex. netTurnover_label = Cifra de afaceri netă). O companie fără bilanț depus returnează un array years gol, cu latestYear null. Datele financiare sunt incluse în aceeași cerere, fără cost suplimentar.

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Schimb valutar

Official Romanian reference exchange rates for RON to foreign currency pairs.

Cursuri oficiale românești de referință pentru perechi RON cu valute străine.

Get a rateObține un curs

Returns the official RON exchange rate for a currency pair. Omit date for the latest publication, or pass it to request a specific calendar date (historical rate). This is a GET endpoint and takes no request body; pass parameters in the query string.

Returnează cursul oficial RON pentru o pereche de valute. Omite date pentru ultima publicare, sau trimite-l pentru a solicita o dată calendaristică specifică (curs istoric). Este un endpoint GET și nu primește corp de cerere; trimite parametrii în query string.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/schimbvalutar?from=RON&to=EUR' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

Example request (historical)Exemplu de cerere (istoric)

curl -sS 'https://api.fint.ro/v1/schimbvalutar?from=RON&to=USD&date=2025-01-15' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'X-Api-Key: YOUR_COMPANY_KEY'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "from": "RON",
    "to": "EUR",
    "date": "2026-05-20",
    "rate": 4.9756,
    "multiplier": 1,
    "source": "bnr",
    "publishedDate": "2026-05-20"
  }
}

Response fieldsCâmpuri de răspuns

rate is RON per 1 unit of to (the official multiplier is already applied).

rate este RON per 1 unitate din to (multiplicatorul oficial este deja aplicat).

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Organization APIAPI Organizație

Manage companies, activate services, and create API keys at the organization level - using your organization key only.

Gestionează companii, activează servicii și creează chei API la nivel de organizație - folosind doar cheia de organizație.

List companiesListare companii

Returns all active companies in the organization, including each company's currently active services. This is a GET endpoint and takes no request body.

Returnează toate companiile active din organizație, inclusiv serviciile active ale fiecărei companii. Este un endpoint GET și nu primește corp de cerere.

Example requestExemplu de cerere

curl -sS 'https://api.fint.ro/v1/organization/companies/list' \
  -H 'X-Org-Key: YOUR_ORG_KEY'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": [
    {
      "uid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "name": "Acme SRL",
      "cui": "12345678",
      "status": "enabled",
      "activeServices": [
        "efactura",
        "extrase"
      ]
    }
  ]
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Create a companyCreare companie

Creates a new company under the organization. The CUI (2-10 digits; optional RO prefix) must be unique within the organization.

Creează o nouă companie în organizație. CUI-ul (2-10 cifre; prefix RO opțional) trebuie să fie unic în organizație.

Example requestExemplu de cerere

curl -sS -X POST 'https://api.fint.ro/v1/organization/companies/create' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Acme SRL","cui":"12345678"}'

Response (201)Răspuns (201)

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "uid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "name": "Acme SRL",
    "cui": "12345678"
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

List available servicesListare servicii disponibile

Returns the service keys that can be activated on a company and used as API key scopes. This is a GET endpoint and takes no request body.

Returnează cheile de serviciu care pot fi activate pe o companie și folosite ca domeniu pentru cheile API. Este un endpoint GET și nu primește corp de cerere.

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": [
    {
      "key": "efactura",
      "label": "eFactura"
    },
    {
      "key": "extrase",
      "label": "Extrase"
    },
    {
      "key": "infocui",
      "label": "Info CUI"
    },
    {
      "key": "schimbvalutar",
      "label": "Schimb valutar"
    }
  ]
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Activate a serviceActivare serviciu

Activates a single service for a company. A company must have a service active before API keys can call it. Use the uid from companies/list. The action is in the URL, so the body only carries the service.

Activează un singur serviciu pentru o companie. O companie trebuie să aibă serviciul activ înainte ca cheile API să-l poată apela. Folosește uid-ul din companies/list. Acțiunea este în URL, deci corpul conține doar serviciul.

Example requestExemplu de cerere

curl -sS -X POST 'https://api.fint.ro/v1/organization/companies/a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4/services/activate' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"service":"efactura"}'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "companyUid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "service": "efactura",
    "active": true
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Deactivate a serviceDezactivare serviciu

Deactivates a single service for a company (removes its service plan). Use the uid from companies/list. The body carries only the service.

Dezactivează un singur serviciu pentru o companie (îi elimină planul de serviciu). Folosește uid-ul din companies/list. Corpul conține doar serviciul.

Example requestExemplu de cerere

curl -sS -X POST 'https://api.fint.ro/v1/organization/companies/a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4/services/deactivate' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"service":"efactura"}'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "companyUid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "service": "efactura",
    "active": false
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

Create a company API keyCreare cheie API pentru companie

Creates a company API key scoped to the given services. Use the uid from companies/list. The plaintext key is returned only once - store it securely. Use the returned key as X-Api-Key on service endpoints together with X-Org-Key.

Creează o cheie API pentru companie, limitată la serviciile indicate. Folosește uid-ul din companies/list. Cheia în clar este returnată o singură dată - stocheaz-o în siguranță. Folosește cheia returnată ca X-Api-Key pe endpoint-urile de servicii împreună cu X-Org-Key.

Example requestExemplu de cerere

curl -sS -X POST 'https://api.fint.ro/v1/organization/companies/a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4/apikeys/create' \
  -H 'X-Org-Key: YOUR_ORG_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"My integration","services":["efactura","infocui"]}'

Response (201)Răspuns (201)

{
  "status": "success",
  "msg": "Store this key securely - it will not be shown again.",
  "reason": null,
  "data": {
    "id": 7,
    "companyUid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "name": "My integration",
    "apiKey": "key_live_Ab3...48chars",
    "services": [
      "efactura",
      "infocui"
    ]
  }
}

Response fieldsCâmpuri de răspuns

ErrorsErori

Also see Authentication errors for key, auth and base rate-limit failures.

Vezi și Erori de autentificare pentru erori de cheie, autentificare și limitare de bază a ratei.

SandboxSandbox

Build and test your integration against https://sandbox.fint.ro - a fully mocked copy of the Fint API that mirrors the live request and response shapes but never touches real providers or real company data.

Construiește și testează integrarea pe https://sandbox.fint.ro - o copie complet simulată a API-ului Fint, care reproduce structura cererilor și răspunsurilor reale, dar nu atinge niciodată furnizorii reali sau date reale de companie.

How it worksCum funcționează

The sandbox is served from a separate host, sandbox.fint.ro, and exposes the same service endpoints as the live API (Extrase, eFactura, Info CUI, Schimb valutar) under the /v1 prefix. Every endpoint returns deterministic mock data, so the same request always yields the same response. Request methods, query parameters, the { status, msg, reason, data } envelope, and reason error codes all match the live API - only the host and the API keys differ.

Sandbox-ul este servit de pe un host separat, sandbox.fint.ro, și expune aceleași endpoint-uri ca API-ul live (Extrase, eFactura, Info CUI, Schimb valutar) sub prefixul /v1. Fiecare endpoint returnează date simulate deterministe, deci aceeași cerere produce mereu același răspuns. Metodele cererilor, parametrii din query, plicul { status, msg, reason, data } și codurile de eroare reason sunt identice cu API-ul live - diferă doar hostul și cheile API.

Differences from the live APIDiferențe față de API-ul live

AuthenticationAutentificare

Sandbox uses the same dual-key authentication as the live API, with one rule: both keys must carry the sandbox prefix. Live keys are rejected with invalid_org_api_key / invalid_api_key, and both keys must belong to the same organization.

Sandbox folosește aceeași autentificare cu două chei ca API-ul live, cu o regulă: ambele chei trebuie să aibă prefixul sandbox. Cheile live sunt respinse cu invalid_org_api_key / invalid_api_key, iar ambele chei trebuie să aparțină aceleiași organizații.

The company key may instead be sent as Authorization: Bearer key_sandbox_….

Cheia de companie poate fi trimisă alternativ ca Authorization: Bearer key_sandbox_….

curl -sS 'https://sandbox.fint.ro/v1/extrase/accounts' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

Obtaining sandbox keysObținerea cheilor sandbox

Generate a sandbox key pair from the same pages as live keys, using the dedicated Cheie sandbox button. Each key is created once and is idempotent - returning to the page shows the same key. Sandbox keys are hidden from the live key list.

Generează o pereche de chei sandbox din aceleași pagini ca cele live, folosind butonul dedicat Cheie sandbox. Fiecare cheie este creată o singură dată și este idempotentă - la revenirea pe pagină apare aceeași cheie. Cheile sandbox nu apar în lista cheilor live.

Reconciliation suggestionsSugestii de reconciliere

Sandbox transactions and documents carry suggestedReconciliation exactly as the live API does - see Extrase and eFactura for the field reference. The fixtures are deterministic, so the same uid always returns the same suggestions.

Tranzacțiile și documentele din sandbox conțin suggestedReconciliation exact ca API-ul live - vezi Extrase și eFactura pentru referința câmpului. Fixture-urile sunt deterministe, deci același uid returnează mereu aceleași sugestii.

The rows that return two suggestions are the important ones to render: both entries share the same amount but carry clearly different confidences (97 and 47). This is the ambiguous case - two invoices to the same client with the same total - and Fint deliberately reports both rather than picking one. Make sure your UI or matching logic handles it.

Rândurile care returnează două sugestii sunt cele importante de randat: ambele intrări au aceeași sumă, dar scoruri de încredere clar diferite (97 și 47). Acesta este cazul ambiguu - două facturi către același client cu același total - iar Fint raportează intenționat ambele, fără să aleagă una. Asigură-te că interfața sau logica ta de potrivire îl tratează.

Sandbox keys are scoped to all services, so suggestedReconciliation is never null here. To exercise the null branch - a key without the other service - use a scoped key on the live API.

Cheile de sandbox au acces la toate serviciile, deci suggestedReconciliation nu este niciodată null aici. Pentru a exersa ramura null - o cheie fără celălalt serviciu - folosește o cheie restrânsă pe API-ul live.

Extrase

Mocks 4 bank accounts (BCR RON, BCR EUR, ING RON, CEC RON), 50 transactions, and 3 bank consents (BCR and ING enabled; CEC disabled/expired). Field and parameter reference is identical to the production Extrase page - only the host and key prefixes differ.

Simulează 4 conturi bancare (BCR RON, BCR EUR, ING RON, CEC RON), 50 de tranzacții și 3 consimțăminte bancare (BCR și ING active; CEC inactiv/expirat). Referința câmpurilor și parametrilor este identică cu pagina de producție Extrase - diferă doar hostul și prefixele cheilor.

Create onboarding linkCreare link de onboarding

Example requestExemplu de cerere

curl -sS -X POST 'https://sandbox.fint.ro/v1/extrase/onboarding' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…' \
  -H 'Content-Type: application/json' \
  -d '{}'

ResponseRăspuns

{
  "status": "success",
  "data": {
    "authLink": "https://sandbox.fint.ro/consent/extrase",
    "expiresOn": "2026-07-06 09:00:00"
  }
}

The authLink opens a mock consent landing page (see Consent pages) - no bank OAuth occurs.

Linkul authLink deschide o pagină de consimțământ simulată (vezi Pagini de consimțământ) - nu are loc niciun OAuth bancar.

Response fieldsCâmpuri de răspuns

Identical to the production Extrase POST /v1/extrase/onboarding response - see its Response fields.

Identice cu răspunsul POST /v1/extrase/onboarding de pe pagina de producție Extrase - vezi Câmpuri de răspuns.

Check consentsVerificare consimțăminte

ResponseRăspuns

{
  "status": "success",
  "data": {
    "consents": [
      {
        "bankCode": "BCR",
        "bankName": "BCR Bank",
        "consentStatus": "enabled",
        "validUntil": "2026-12-26",
        "updatedOn": "2026-06-26 09:00:00"
      },
      {
        "bankCode": "ING",
        "bankName": "ING Bank",
        "consentStatus": "enabled",
        "validUntil": "2026-12-26",
        "updatedOn": "2026-06-26 09:00:00"
      },
      {
        "bankCode": "CEC",
        "bankName": "CEC Bank SA",
        "consentStatus": "disabled",
        "validUntil": "2026-06-19",
        "updatedOn": "2026-03-21 09:00:00"
      }
    ],
    "total": 3
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production Extrase GET /v1/extrase/consents response - see its Response fields.

Identice cu răspunsul GET /v1/extrase/consents de pe pagina de producție Extrase - vezi Câmpuri de răspuns.

List accountsListare conturi

Example requestExemplu de cerere

curl -sS 'https://sandbox.fint.ro/v1/extrase/accounts' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

Response (first of 4 accounts)Răspuns (primul din 4 conturi)

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "accounts": [
      {
        "uid": "bcrron0000000000000000000000acc1",
        "status": "enabled",
        "iban": "RO49RNCB0000000000000001",
        "currency": "RON",
        "balance": "15230.45",
        "name": "Cont curent RON",
        "ownerName": "Sandbox Test SRL",
        "product": "Cont curent",
        "cashAccountType": "CACC",
        "bic": "RNCBROBU",
        "bank": {
          "code": "BCR",
          "name": "BCR Bank",
          "bic": "RNCBROBU",
          "icon": "https://cdn.fint.ro/image/bank/icon/bcr.png"
        },
        "consentStatus": "enabled",
        "consentValidUntil": "2026-12-26",
        "lastTransactionsSync": "2026-06-29 07:00:00",
        "createdOn": "2026-06-29 09:00:00",
        "updatedOn": "2026-06-29 09:00:00"
      }
    ],
    "total": 4
  }
}

The CEC RON account is returned too, but with consentStatus: disabled and an expired consentValidUntil.

Contul CEC RON este returnat și el, dar cu consentStatus: disabled și un consentValidUntil expirat.

Response fieldsCâmpuri de răspuns

Identical to the production Extrase GET /v1/extrase/accounts response - see its Response fields.

Identice cu răspunsul GET /v1/extrase/accounts de pe pagina de producție Extrase - vezi Câmpuri de răspuns.

List transactionsListare tranzacții

Supports the same query parameters as live: limit, offset, type, accountUid, from, to, q. Transactions belong only to the three enabled accounts (the disabled CEC account returns none).

Acceptă aceiași parametri de query ca live: limit, offset, type, accountUid, from, to, q. Tranzacțiile aparțin doar celor trei conturi active (contul CEC inactiv nu returnează niciuna).

Example requestExemplu de cerere

curl -sS 'https://sandbox.fint.ro/v1/extrase/transactions?limit=50&offset=0' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "transactions": [
      {
        "uid": "txn00000000000000000000000000001",
        "type": "outgoing",
        "bookingDate": "2026-06-28",
        "interlocutor": "Enel Energie SA",
        "interlocutorIban": "RO55BACX0000000000000555",
        "amount": "-73.30",
        "currency": "RON",
        "fintDescription": "Factura energie electrica",
        "rawDescription": "Factura energie electrica / ref 1",
        "category": "utilities",
        "createdOn": "2026-06-28 09:00:00",
        "accountUid": "bcrron0000000000000000000000acc1",
        "accountIban": "RO49RNCB0000000000000001",
        "accountName": "Cont curent RON",
        "bank": {
          "code": "BCR",
          "name": "BCR Bank",
          "bic": "RNCBROBU",
          "icon": "https://cdn.fint.ro/image/bank/icon/bcr.png"
        },
        "executionDateTime": "2026-06-28 09:00:00",
        "entryReference": "ENTRY-000001",
        "endToEndId": "E2E-000001",
        "transactionStatus": "BOOK",
        "additionalInformation": "Factura energie electrica / ref 1",
        "merchantName": "Enel Energie SA",
        "creditorName": "Enel Energie SA",
        "creditorAccountIban": "RO55BACX0000000000000555",
        "debtorName": "Cont curent RON",
        "debtorAccountIban": "RO49RNCB0000000000000001",
        "userNote": ""
      }
    ],
    "total": 50,
    "limit": 50,
    "offset": 0
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production Extrase GET /v1/extrase/transactions response - see its Response fields.

Identice cu răspunsul GET /v1/extrase/transactions de pe pagina de producție Extrase - vezi Câmpuri de răspuns.

Get a transactionObținere tranzacție

Use a uid from the list above (e.g. txn00000000000000000000000000001). The detail response returns the same per-transaction structure as the list above - including provider fields such as executionDateTime, entryReference and endToEndId.

Folosește un uid din lista de mai sus (ex. txn00000000000000000000000000001). Răspunsul detaliat returnează aceeași structură per tranzacție ca lista de mai sus - inclusiv câmpuri de la furnizor precum executionDateTime, entryReference și endToEndId.

curl -sS 'https://sandbox.fint.ro/v1/extrase/transaction/txn00000000000000000000000000001' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

Response fieldsCâmpuri de răspuns

Identical to the production Extrase GET /v1/extrase/transaction/{uid} response - see its Response fields.

Identice cu răspunsul GET /v1/extrase/transaction/{uid} de pe pagina de producție Extrase - vezi Câmpuri de răspuns.

ErrorsErori

The reason codes match the live API. Authentication errors are the same as Authentication, except both keys must carry the sandbox prefix. 429 limit_exceeded is never returned - limits are not enforced in sandbox.

Codurile reason corespund API-ului live. Erorile de autentificare sunt aceleași ca la Autentificare, cu excepția că ambele chei trebuie să aibă prefixul sandbox. 429 limit_exceeded nu este returnat niciodată - limitele nu sunt aplicate în sandbox.

eFactura

Mocks 50 documents (30 outgoing, 20 incoming, including two type 381 credit notes). Document uids are production-shaped with a sandbox_ prefix (^sandbox_[A-Za-z0-9]{32}$) and are deterministic. The request-body field reference is documented under the production eFactura page’s Send a document endpoint and applies here unchanged.

Simulează 50 de documente (30 emise, 20 primite, inclusiv două note de creditare tip 381). Uid-urile documentelor au forma de producție cu prefix sandbox_ (^sandbox_[A-Za-z0-9]{32}$) și sunt deterministe. Referința câmpurilor din corpul cererii este documentată la endpoint-ul Trimitere document din pagina de producție eFactura și se aplică aici neschimbată.

Create onboarding linkCreare link de onboarding

ResponseRăspuns

{
  "status": "success",
  "data": {
    "authLink": "https://sandbox.fint.ro/consent/efactura",
    "expiresOn": "2026-07-06 09:00:00"
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production eFactura POST /v1/efactura/onboarding response - see its Response fields.

Identice cu răspunsul POST /v1/efactura/onboarding de pe pagina de producție eFactura - vezi Câmpuri de răspuns.

Check consentVerificare consimțământ

ResponseRăspuns

{
  "status": "success",
  "data": {
    "consentStatus": "enabled",
    "validUntil": "2026-12-26",
    "updatedOn": "2026-06-26 09:00:00"
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production eFactura GET /v1/efactura/consent response - see its Response fields.

Identice cu răspunsul GET /v1/efactura/consent de pe pagina de producție eFactura - vezi Câmpuri de răspuns.

Send a documentTrimitere document

Validates the document structure with the same rules as the live API - required fields, party/address shape, the from.cui / consent match, and the vatScheme / vatRate coupling (see the request body fields on the production eFactura page). On success it returns 201 with the uid of the first mock outgoing pending document - you can immediately fetch it with GET /v1/efactura/document/{uid}. An invalid document returns 422 validation_failed with a data.errors array. Nothing is uploaded to ANAF, and - unlike live - there is no ANAF pre-validation or duplicate-number check.

Validează structura documentului cu aceleași reguli ca API-ul live - câmpuri obligatorii, forma părților/adreselor, potrivirea from.cui cu consimțământul și corelarea vatScheme / vatRate (vezi câmpurile din corpul cererii pe pagina de producție eFactura). La succes returnează 201 cu uid-ul primului document emis simulat cu status pending - îl poți obține imediat cu GET /v1/efactura/document/{uid}. Un document invalid returnează 422 validation_failed cu un array data.errors. Nimic nu este încărcat la ANAF și - spre deosebire de live - nu există pre-validare ANAF sau verificare de număr duplicat.

curl -sS -X POST 'https://sandbox.fint.ro/v1/efactura/send' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…' \
  -H 'Content-Type: application/json' \
  -d '{
    "documentNumber": "TEST-1",
    "documentDate": "2026-06-29",
    "currency": "RON",
    "documentTypeCode": "380",
    "from": {
      "cui": "123456",
      "name": "Sandbox Test SRL",
      "address": { "line": "Str. Exemplu nr. 10", "city": "SECTOR1", "countrySubdivision": "RO-B", "country": "RO", "postalCode": "010101" },
      "regCom": "J40/1234/2020"
    },
    "to": {
      "cui": "654321",
      "name": "Buyer SRL",
      "address": { "line": "Bd. Unirii nr. 5", "city": "SECTOR1", "countrySubdivision": "RO-B", "country": "RO", "postalCode": "030101" },
      "regCom": "J40/1001/2015"
    },
    "items": [
      {
        "name": "Service",
        "quantity": 1,
        "price": 100,
        "vatRate": 21,
        "vatScheme": "S"
      }
    ]
  }'

{
  "documentNumber": "TEST-1",
  "documentDate": "2026-06-29",
  "currency": "RON",
  "documentTypeCode": "380",
  "from": {
    "cui": "123456",
    "name": "Sandbox Test SRL",
    "address": { "line": "Str. Exemplu nr. 10", "city": "SECTOR1", "countrySubdivision": "RO-B", "country": "RO", "postalCode": "010101" },
    "regCom": "J40/1234/2020"
  },
  "to": {
    "cui": "654321",
    "name": "Buyer SRL",
    "address": { "line": "Bd. Unirii nr. 5", "city": "SECTOR1", "countrySubdivision": "RO-B", "country": "RO", "postalCode": "030101" },
    "regCom": "J40/1001/2015"
  },
  "items": [
    {
      "name": "Service",
      "quantity": 1,
      "price": 100,
      "vatRate": 21,
      "vatScheme": "S"
    }
  ]
}

Response (201)Răspuns (201)

{
  "status": "success",
  "msg": "Document has been validated with Fint. Pending upload and ANAF confirmation.",
  "reason": null,
  "data": {
    "uid": "sandbox_XqdTICN1YmGkD8RV3cUE0keIZkRMoufc",
    "status": "pending"
  }
}

Response (422 validation failed)Răspuns (422 validare eșuată)

{
  "status": "error",
  "msg": "Document is not valid.",
  "reason": "validation_failed",
  "data": {
    "errors": [
      {
        "code": "from_cui_mismatch",
        "field": "from.cui",
        "message": "from.cui must match the enabled eFactura consent CUI for this license"
      }
    ]
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production eFactura POST /v1/efactura/send response - see its Response fields.

Identice cu răspunsul POST /v1/efactura/send de pe pagina de producție eFactura - vezi Câmpuri de răspuns.

List documentsListare documente

Same query parameters as live: type (all default - both directions - or outgoing/incoming), limit, offset, status (unknown status values return 400 invalid_status, as in production). Outgoing fixtures cycle through pending, sent, validated, rejected and failed; incoming fixtures through validated, pending and rejected.

Aceiași parametri de query ca live: type (all implicit - ambele direcții - sau outgoing/incoming), limit, offset, status (valorile necunoscute de status returnează 400 invalid_status, ca în producție). Fixture-urile emise trec ciclic prin pending, sent, validated, rejected și failed; cele primite prin validated, pending și rejected.

curl -sS 'https://sandbox.fint.ro/v1/efactura/documents?type=incoming&limit=50&offset=0' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "documents": [
      {
        "uid": "sandbox_…",
        "type": "incoming",
        "status": "validated",
        "source": "spv",
        "documentTypeCode": "380",
        "documentNumber": "SUP-IN-0001",
        "documentDate": "2026-06-28",
        "currency": "RON",
        "fromTo": "Alpha Distribution SRL",
        "fromToCui": "RO234567",
        "total": "167.75",
        "anafStatus": "ok",
        "anafId": "6000000001",
        "processed": 1,
        "createdOn": "2026-06-28 09:00:00",
        "updatedOn": "2026-06-28 09:30:00"
      }
    ],
    "total": 20,
    "limit": 50,
    "offset": 0
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production eFactura GET /v1/efactura/documents response - see its Response fields.

Identice cu răspunsul GET /v1/efactura/documents de pe pagina de producție eFactura - vezi Câmpuri de răspuns.

Get a documentObținere document

Example requestExemplu de cerere

curl -sS 'https://sandbox.fint.ro/v1/efactura/document/sandbox_XqdTICN1YmGkD8RV3cUE0keIZkRMoufc' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

ResponseRăspuns

{
  "status": "success",
  "data": {
    "uid": "sandbox_XqdTICN1YmGkD8RV3cUE0keIZkRMoufc",
    "type": "outgoing",
    "status": "pending",
    "errorMessage": null,
    "source": "fint",
    "documentTypeCode": "380",
    "documentNumber": "SBX-OUT-0001",
    "documentDate": "2026-06-28",
    "currency": "RON",
    "fromTo": "Alpha Distribution SRL",
    "fromToCui": "RO234567",
    "total": "173.50",
    "anafStatus": null,
    "anafId": null,
    "pdfAvailable": 0,
    "xmlAvailable": 0,
    "processed": 1,
    "createdOn": "2026-06-28 09:00:00",
    "updatedOn": "2026-06-28 09:30:00",
    "note": "Document sandbox - date simulate.",
    "dueDate": "2026-07-28",
    "buyerReference": null,
    "deliveryDate": "2026-06-28",
    "deliveryAddress": null,
    "from": {
      "cui": "123456",
      "name": "Sandbox Test SRL",
      "address": {
        "line": "Str. Exemplu nr. 10",
        "city": "București",
        "postalCode": "010101",
        "countrySubdivision": "RO-B",
        "country": "RO"
      },
      "regCom": "J40/1234/2020"
    },
    "to": {
      "cui": "234567",
      "name": "Alpha Distribution SRL",
      "address": {
        "line": "Bd. Unirii nr. 5",
        "city": "București",
        "postalCode": "030101",
        "countrySubdivision": "RO-B",
        "country": "RO"
      },
      "regCom": "J40/1001/2015"
    },
    "items": [
      {
        "name": "Servicii sandbox",
        "quantity": 1,
        "price": 157.73,
        "vatRate": 21,
        "vatScheme": "S",
        "currency": "RON",
        "value": "157.73"
      },
      {
        "name": "Reducere comercială",
        "quantity": 1,
        "price": 14.34,
        "vatRate": 21,
        "vatScheme": "S",
        "currency": "RON",
        "value": "-14.34"
      }
    ],
    "paymentMeans": {
      "paymentMeansCode": "30",
      "paymentId": "SBX-OUT-0001",
      "iban": "RO49RNCB0000000000000001",
      "accountName": "Sandbox Test SRL",
      "bic": "RNCBROBU"
    }
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production eFactura GET /v1/efactura/document/{uid} response - see its Response fields.

Identice cu răspunsul GET /v1/efactura/document/{uid} de pe pagina de producție eFactura - vezi Câmpuri de răspuns.

Download a documentDescărcare document

No binary files exist in the sandbox, so this endpoint always returns 404 sandbox_download_unavailable.

În sandbox nu există fișiere binare, așa că acest endpoint returnează mereu 404 sandbox_download_unavailable.

{
  "status": "error",
  "msg": null,
  "reason": "sandbox_download_unavailable",
  "data": null
}

ErrorsErori

/send runs the same structural validation as the live API (returns 422 validation_failed with a data.errors array of {code, field, message} objects), but skips the ANAF UBL pre-check and the duplicate-number check. So the live-only errors 409 duplicate_document, 500 enqueue_failed and 429 limit_exceeded do not occur here.

/send rulează aceeași validare structurală ca API-ul live (returnează 422 validation_failed cu un array data.errors de obiecte {code, field, message}), dar sare peste pre-verificarea UBL la ANAF și verificarea numărului duplicat. Astfel, erorile specifice live 409 duplicate_document, 500 enqueue_failed și 429 limit_exceeded nu apar aici.

Info CUI

Most CUIs return a fixed mock company, Sandbox Test SRL. The special CUI RO222222 returns 404 company_not_found so you can test the not-found path. Field reference is identical to the production Info CUI page.

Majoritatea CUI-urilor returnează o companie simulată fixă, Sandbox Test SRL. CUI-ul special RO222222 returnează 404 company_not_found, ca să poți testa cazul „negăsit”. Referința câmpurilor este identică cu pagina de producție Info CUI.

Example requestExemplu de cerere

curl -sS 'https://sandbox.fint.ro/v1/infocui?cui=RO123456' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "cui": "123456",
    "name": "Sandbox Test SRL",
    "registrationNumber": "J40/1234/2015",
    "address": "Str. Exemplu nr. 10, Sector 1",
    "addressFull": "Str. Exemplu nr. 10, Sector 1, București, România",
    "city": "București",
    "county": "București",
    "countyCode": "B",
    "country": "România",
    "postalCode": "010101",
    "phone": "+40212345678",
    "fax": null,
    "iban": "RO49RNCB0000000000000001",
    "registrationStatus": "INREGISTRAT din data 2015-03-12",
    "registrationDate": "2015-03-12",
    "caenCode": "6201",
    "eInvoiceEnabled": true,
    "taxAuthority": "Administrația Sector 1",
    "legalForm": "Societate cu răspundere limitată",
    "vatRegistered": true,
    "cashVatEnabled": false,
    "financials": {
      "currency": "RON",
      "latestYear": 2024,
      "years": [
        {
          "year": 2024,
          "caenCode": "6201",
          "caenCode_label": "Cod CAEN",
          "employees": 12,
          "employees_label": "Număr mediu de salariați",
          "netTurnover": 2100000,
          "netTurnover_label": "Cifra de afaceri netă",
          "totalRevenue": 2150000,
          "totalRevenue_label": "Venituri totale",
          "totalExpenses": 1800000,
          "totalExpenses_label": "Cheltuieli totale",
          "grossProfit": 350000,
          "grossProfit_label": "Profit brut",
          "grossLoss": 0,
          "grossLoss_label": "Pierdere brută",
          "netProfit": 294000,
          "netProfit_label": "Profit net",
          "netLoss": 0,
          "netLoss_label": "Pierdere netă",
          "fixedAssets": 150000,
          "fixedAssets_label": "Active imobilizate",
          "currentAssets": 900000,
          "currentAssets_label": "Active circulante",
          "inventory": 50000,
          "inventory_label": "Stocuri",
          "receivables": 200000,
          "receivables_label": "Creanțe",
          "cash": 650000,
          "cash_label": "Casa și conturi la bănci",
          "prepaidExpenses": 0,
          "prepaidExpenses_label": "Cheltuieli în avans",
          "liabilities": 300000,
          "liabilities_label": "Datorii",
          "deferredRevenue": 0,
          "deferredRevenue_label": "Venituri în avans",
          "provisions": 0,
          "provisions_label": "Provizioane",
          "equity": 750000,
          "equity_label": "Capitaluri total",
          "paidCapital": 200,
          "paidCapital_label": "Capital subscris vărsat",
          "publicPatrimony": 0,
          "publicPatrimony_label": "Patrimoniul regiei"
        },
        {
          "year": 2023,
          "caenCode": "6201",
          "caenCode_label": "Cod CAEN",
          "employees": 10,
          "employees_label": "Număr mediu de salariați",
          "netTurnover": 1700000,
          "netTurnover_label": "Cifra de afaceri netă",
          "totalRevenue": 1730000,
          "totalRevenue_label": "Venituri totale",
          "totalExpenses": 1500000,
          "totalExpenses_label": "Cheltuieli totale",
          "grossProfit": 230000,
          "grossProfit_label": "Profit brut",
          "grossLoss": 0,
          "grossLoss_label": "Pierdere brută",
          "netProfit": 193000,
          "netProfit_label": "Profit net",
          "netLoss": 0,
          "netLoss_label": "Pierdere netă",
          "fixedAssets": 120000,
          "fixedAssets_label": "Active imobilizate",
          "currentAssets": 700000,
          "currentAssets_label": "Active circulante",
          "inventory": 40000,
          "inventory_label": "Stocuri",
          "receivables": 160000,
          "receivables_label": "Creanțe",
          "cash": 500000,
          "cash_label": "Casa și conturi la bănci",
          "prepaidExpenses": 0,
          "prepaidExpenses_label": "Cheltuieli în avans",
          "liabilities": 250000,
          "liabilities_label": "Datorii",
          "deferredRevenue": 0,
          "deferredRevenue_label": "Venituri în avans",
          "provisions": 0,
          "provisions_label": "Provizioane",
          "equity": 570000,
          "equity_label": "Capitaluri total",
          "paidCapital": 200,
          "paidCapital_label": "Capital subscris vărsat",
          "publicPatrimony": 0,
          "publicPatrimony_label": "Patrimoniul regiei"
        },
        {
          "year": 2022,
          "caenCode": "6201",
          "caenCode_label": "Cod CAEN",
          "employees": 8,
          "employees_label": "Număr mediu de salariați",
          "netTurnover": 1200000,
          "netTurnover_label": "Cifra de afaceri netă",
          "totalRevenue": 1220000,
          "totalRevenue_label": "Venituri totale",
          "totalExpenses": 1080000,
          "totalExpenses_label": "Cheltuieli totale",
          "grossProfit": 140000,
          "grossProfit_label": "Profit brut",
          "grossLoss": 0,
          "grossLoss_label": "Pierdere brută",
          "netProfit": 117600,
          "netProfit_label": "Profit net",
          "netLoss": 0,
          "netLoss_label": "Pierdere netă",
          "fixedAssets": 90000,
          "fixedAssets_label": "Active imobilizate",
          "currentAssets": 500000,
          "currentAssets_label": "Active circulante",
          "inventory": 30000,
          "inventory_label": "Stocuri",
          "receivables": 120000,
          "receivables_label": "Creanțe",
          "cash": 350000,
          "cash_label": "Casa și conturi la bănci",
          "prepaidExpenses": 0,
          "prepaidExpenses_label": "Cheltuieli în avans",
          "liabilities": 200000,
          "liabilities_label": "Datorii",
          "deferredRevenue": 0,
          "deferredRevenue_label": "Venituri în avans",
          "provisions": 0,
          "provisions_label": "Provizioane",
          "equity": 390000,
          "equity_label": "Capitaluri total",
          "paidCapital": 200,
          "paidCapital_label": "Capital subscris vărsat",
          "publicPatrimony": 0,
          "publicPatrimony_label": "Patrimoniul regiei"
        }
      ]
    }
  }
}

Response fieldsCâmpuri de răspuns

Identical to the production Info CUI GET /v1/infocui response - see its Response fields.

Identice cu răspunsul GET /v1/infocui de pe pagina de producție Info CUI - vezi Câmpuri de răspuns.

ErrorsErori

reason codes match the live API. The special CUI RO222222 is wired to return 404 company_not_found so you can exercise the not-found path; every other well-formed CUI returns the mock company. 429 limit_exceeded is not enforced in sandbox.

Codurile reason corespund API-ului live. CUI-ul special RO222222 este configurat să returneze 404 company_not_found pentru a testa cazul negăsit; orice alt CUI bine format returnează compania simulată. 429 limit_exceeded nu este aplicat în sandbox.

Schimb valutar

Returns fixed mock rates with no upstream fetch: EUR 5.2390, USD 4.8500, GBP 6.1200, CHF 5.4500, HUF 1.3120 (per 100). from must be RON; an optional date is echoed back unchanged (no banking-day fallback in sandbox). Field reference is identical to the production Schimb valutar page.

Returnează cursuri simulate fixe, fără apel extern: EUR 5.2390, USD 4.8500, GBP 6.1200, CHF 5.4500, HUF 1.3120 (la 100). from trebuie să fie RON; un date opțional este returnat neschimbat (fără fallback la ziua bancară în sandbox). Referința câmpurilor este identică cu pagina de producție Schimb valutar.

Example requestExemplu de cerere

curl -sS 'https://sandbox.fint.ro/v1/schimbvalutar?from=RON&to=EUR' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

Example request (historical)Exemplu de cerere (istoric)

curl -sS 'https://sandbox.fint.ro/v1/schimbvalutar?from=RON&to=USD&date=2025-01-15' \
  -H 'X-Org-Key: org_sandbox_…' \
  -H 'X-Api-Key: key_sandbox_…'

ResponseRăspuns

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "from": "RON",
    "to": "EUR",
    "date": "2026-06-29",
    "rate": 5.239,
    "multiplier": 1,
    "source": "bnr",
    "publishedDate": "2026-06-29"
  }
}

rate is RON per 1 unit of to (the official multiplier is already applied).

rate este RON per 1 unitate din to (multiplicatorul oficial este deja aplicat).

Response fieldsCâmpuri de răspuns

Identical to the production Schimb valutar GET /v1/schimbvalutar response - see its Response fields.

Identice cu răspunsul GET /v1/schimbvalutar de pe pagina de producție Schimb valutar - vezi Câmpuri de răspuns.

ErrorsErori

from must be RON and to must be one of the five mocked currencies (EUR, USD, GBP, CHF, HUF); any other currency returns 404 rate_not_found. Because sandbox serves fixed rates and never contacts an upstream source, 502 provider_error cannot occur, and 429 limit_exceeded is not enforced.

from trebuie să fie RON, iar to una dintre cele cinci valute simulate (EUR, USD, GBP, CHF, HUF); orice altă valută returnează 404 rate_not_found. Deoarece sandbox-ul servește cursuri fixe și nu contactează nicio sursă externă, 502 provider_error nu poate apărea, iar 429 limit_exceeded nu este aplicat.

Consent landing pagesPagini de consimțământ

Onboarding endpoints return an authLink that opens in a browser. In sandbox these resolve to mock success pages - same layout as production, but no provider redirect, session, or database write.

Endpoint-urile de onboarding returnează un authLink care se deschide în browser. În sandbox acestea duc la pagini de succes simulate - același aspect ca producția, dar fără redirecționare către furnizor, sesiune sau scriere în baza de date.

WebhooksWebhook-uri

Webhooks push a signed JSON payload to a URL you control the moment something happens in eFactura or Extrase, so you don’t have to poll the API.

Webhook-urile trimit un payload JSON semnat către o adresă pe care o controlezi, în momentul în care se întâmplă ceva în eFactura sau Extrase, ca să nu fie nevoie să interoghezi API-ul.

Setting up an endpointConfigurarea unui endpoint

1. Create the endpoint. Open Companie → Webhook-uri and click Webhook nou.
2. Creează endpoint-ul. Deschide Companie → Webhook-uri și apasă Webhook nou.
3. Choose the URL and events. Enter your HTTPS URL, pick the events you want, and save.
4. Alege adresa și evenimentele. Introdu adresa HTTPS, alege evenimentele dorite și salvează.
5. Save the signing secret. Fint shows a signing secret (whsec_…) once - copy it now; it is never shown again. Use it to verify every delivery. You can regenerate it later from the endpoint’s actions menu (⋮) via Regenerează secret, which immediately invalidates the old one.
6. Salvează secretul de semnare. Fint afișează un secret de semnare (whsec_…) o singură dată - copiază-l acum; nu va mai fi afișat. Folosește-l pentru a verifica fiecare livrare. Îl poți regenera ulterior din meniul de acțiuni (⋮) prin Regenerează secret, ceea ce invalidează imediat secretul vechi.
7. Send a test. Use Trimite test from the actions menu to send a webhook.ping and confirm your endpoint receives it.
8. Trimite un test. Folosește Trimite test din meniul de acțiuni pentru a trimite un webhook.ping și a confirma că endpoint-ul îl primește.
9. Watch deliveries. Istoric webhook (the actions menu) shows every delivery, its status and HTTP code, and lets you redeliver one manually.
10. Urmărește livrările. Istoric webhook (meniul de acțiuni) arată fiecare livrare, statusul și codul HTTP, și îți permite să retrimiți manual o livrare.

EventsEvenimente

Delivery formatFormatul livrării

Each delivery is an HTTP POST with Content-Type: application/json and these headers:

Fiecare livrare este un POST HTTP cu Content-Type: application/json și următoarele header-e:

The body is a stable envelope; data is specific to each event:

Corpul este o envelopă stabilă; data este specific fiecărui eveniment:

{
  "id": "hd8s0f...",
  "type": "efactura.document.validated",
  "createdAt": "2026-08-12 10:04:33",
  "companyUid": "oyUsdORx...",
  "data": {
    "documentUid": "a1b2c3...",
    "status": "validated",
    "type": "outgoing",
    "total": 1190.0,
    "currency": "RON"
  }
}

Respond with any 2xx status to acknowledge. Any other status, or a timeout, counts as a failure and is retried.

Răspunde cu orice status 2xx pentru a confirma. Orice alt status, sau un timeout, este considerat eșec și se reîncearcă.

Verifying the signatureVerificarea semnăturii

Every request carries a Fint-Signature header of the form t=<timestamp>,v1=<signature>. Compute an HMAC-SHA256 over "{t}.{rawBody}" using your endpoint secret and compare it, in constant time, to v1. Reject the request if the timestamp is outside a tolerance window (300 seconds is a good default) to guard against replay.

Fiecare cerere poartă un header Fint-Signature de forma t=<timestamp>,v1=<semnătură>. Calculează un HMAC-SHA256 peste "{t}.{rawBody}" folosind secretul endpoint-ului și compară-l, în timp constant, cu v1. Respinge cererea dacă marcajul de timp este în afara unei ferestre de toleranță (300 de secunde este o valoare implicită bună) pentru a preveni atacurile de tip replay.

import crypto from 'node:crypto';

function fintVerifyWebhook(rawBody, sigHeader, secret, toleranceSeconds = 300) {
  const parts = Object.fromEntries(
    String(sigHeader).split(',').map((p) => p.split('=').map((s) => s.trim())),
  );
  if (!parts.t || !parts.v1 || !/^\d+$/.test(parts.t)) return false;
  if (Math.abs(Math.floor(Date.now() / 1000) - Number(parts.t)) > toleranceSeconds) return false;

  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${parts.t}.${rawBody}`)
    .digest('hex');

  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Always verify against the raw request body exactly as received - do not re-serialize the JSON first, or the signature will not match.

Verifică întotdeauna pe baza corpului brut al cererii, exact cum a fost primit - nu re-serializa JSON-ul întâi, altfel semnătura nu se va potrivi.

Retries and idempotencyReîncercări și idempotență

Delivery is at-least-once, so the same event may arrive more than once (for example after a network hiccup). Deduplicate on the Fint-Delivery id, which is unique per delivery and echoed in the body as id.

Livrarea este cel puțin o dată, deci același eveniment poate ajunge de mai multe ori (de exemplu după o problemă de rețea). Deduplică după id-ul Fint-Delivery, care este unic per livrare și este reluat în corp ca id.

A failed delivery is retried with exponential backoff - roughly 1m, 5m, 30m, 2h, 6h, 12h, 24h - up to 8 attempts. After that it is marked failed and kept in Istoric webhook, where you can redeliver it manually. An endpoint that fails many deliveries in a row is automatically disabled; re-enable it after fixing the receiver.

O livrare eșuată se reîncearcă cu backoff exponențial - aproximativ 1m, 5m, 30m, 2h, 6h, 12h, 24h - până la 8 încercări. După aceea este marcată ca eșuată și păstrată în Istoric webhook, de unde o poți retrimite manual. Un endpoint care eșuează multe livrări la rând este dezactivat automat; reactivează-l după ce repari receptorul.

ConceptsConcepte

Background on the Romanian financial and regulatory context behind Fint's services. Useful if you are new to open banking, e-invoicing, or Romanian tax identifiers.

Context financiar și de reglementare românesc din spatele serviciilor Fint. Util dacă ești nou în open banking, facturare electronică sau identificatori fiscali românești.

Open Banking (PSD2)Open Banking (PSD2)

PSD2 (the EU Payment Services Directive 2) requires banks to expose customer account data and payment initiation via standardized APIs, provided the account holder has given explicit consent. The consent is established through an OAuth flow with the bank: the account holder authenticates at their bank and authorizes a third party to read their accounts and transactions.

PSD2 (Directiva europeană privind serviciile de plată 2) obligă băncile să expună date de cont și inițiere de plăți prin API-uri standardizate, cu condiția consimțământului explicit al titularului de cont. Consimțământul se stabilește printr-un flux OAuth cu banca: titularul se autentifică la bancă și autorizează o terță parte să citească conturile și tranzacțiile.

In Fint's Extrase service, this means each connected bank requires its own PSD2 consent. Once authorized, Fint keeps accounts, balances, and transactions synchronized from the bank. The public API returns this already-synchronized data; it does not call the bank in real time. Consents have a validity period set by the bank; Fint maintains the connection and notifies your organization when a consent expires or is revoked.

În serviciul Extrase Fint, asta înseamnă că fiecare bancă conectată necesită propriul consimțământ PSD2. Odată autorizat, Fint menține conturile, soldurile și tranzacțiile sincronizate de la bancă. API-ul public returnează aceste date deja sincronizate; nu apelează banca în timp real. Consimțămintele au o perioadă de valabilitate stabilită de bancă; Fint menține conexiunea și notifică organizația când un consimțământ expiră sau este revocat.

See Extrase for API endpoints and consent setup.

Vezi Extrase pentru endpoint-uri API și configurarea consimțământului.

eFactura (Romanian e-invoicing)eFactura (facturare electronică românească)

eFactura is the Romanian government's electronic invoicing system, operated by ANAF (Agenția Națională de Administrare Fiscală). Businesses in Romania are legally required to submit and receive invoices electronically through ANAF's SPV (Spațiu Privat Virtual). Invoices are formatted as UBL 2.1 XML; ANAF validates the document and countersigns it upon acceptance.

eFactura este sistemul guvernamental român de facturare electronică, operat de ANAF (Agenția Națională de Administrare Fiscală). Afacerile din România sunt obligate legal să trimită și să primească facturi electronic prin SPV ANAF (Spațiu Privat Virtual). Facturile sunt formatate ca UBL 2.1 XML; ANAF validează documentul și îl contrasemnează la acceptare.

To submit invoices via Fint, the company must have active SPV access at ANAF and must authorize Fint through an ANAF OAuth consent. This authorization can only be completed by a person who holds a qualified digital certificate registered at ANAF for that company's CUI. Once authorized, Fint submits outgoing documents to ANAF and provides incoming documents received from other parties.

Pentru a trimite facturi prin Fint, compania trebuie să aibă acces SPV activ la ANAF și să autorizeze Fint printr-un consimțământ OAuth ANAF. Această autorizare poate fi finalizată doar de o persoană cu certificat digital calificat înregistrat la ANAF pentru CUI-ul companiei. Odată autorizat, Fint trimite documentele de ieșire la ANAF și furnizează documente de intrare primite de la alte părți.

The most common document type is 380 (standard invoice). Other types include 381 (credit note) and 384 (corrective invoice). See eFactura for the full API reference and consent setup.

Cel mai frecvent tip de document este 380 (factură standard). Alte tipuri includ 381 (notă de creditare) și 384 (factură corectată). Vezi eFactura pentru referința API completă și configurarea consimțământului.

CUI (Cod Unic de Înregistrare)CUI (Cod Unic de Înregistrare)

The CUI is the Romanian company fiscal identifier, roughly equivalent to a VAT or company registration number in other EU countries. It uniquely identifies a legal entity registered in Romania. A CUI may appear with or without the RO prefix (e.g. RO12345678 or 12345678); Fint normalizes all inputs to digits only.

CUI-ul este identificatorul fiscal al companiei românești, echivalent aproximativ cu numărul de TVA sau de înregistrare în alte țări UE. Identifică unic o entitate juridică înregistrată în România. Un CUI poate apărea cu sau fără prefixul RO (ex. RO12345678 sau 12345678); Fint normalizează toate intrările la cifre.

The CUI is used in two ways within Fint: as the lookup target in Info CUI (retrieve public company data for any valid Romanian CUI), and as the company identifier in eFactura where from.cui must match the CUI for which your ANAF consent was granted.

CUI-ul este folosit în două moduri în Fint: ca țintă de căutare în Info CUI (recuperează date publice despre companie pentru orice CUI românesc valid) și ca identificator de companie în eFactura, unde from.cui trebuie să coincidă cu CUI-ul pentru care ai primit consimțământ ANAF.

Reference exchange ratesCursuri de referință

One official Romanian reference exchange rate is published per foreign currency per banking day, typically around 13:00 local time. Rates are expressed as RON per 1 unit of the foreign currency, with a multiplier applied for currencies quoted in lots (e.g. 100 JPY). These are official reference rates used for accounting and fiscal purposes, not live market trading rates.

Se publică un curs oficial românesc de referință per valută străină per zi bancară, de obicei în jurul orei 13:00 ora locală. Cursurile sunt exprimate ca RON per 1 unitate de valută străină, cu multiplicator aplicat pentru valute cotate în loturi (ex. 100 JPY). Sunt cursuri oficiale de referință pentru contabilitate și fiscalitate, nu cursuri de tranzacționare live.

When querying a rate for a date when no publication exists (weekends, public holidays, or before the daily update), Fint returns the most recent available rate with its actual publication date in publishedDate. Future dates are rejected with 400 future_date. See Schimb valutar for the API reference.

Când interoghezi un curs pentru o dată fără publicare (weekend, sărbători legale sau înainte de actualizarea zilnică), Fint returnează cel mai recent curs disponibil cu data reală de publicare în publishedDate. Datele viitoare sunt respinse cu 400 future_date. Vezi Schimb valutar pentru referința API.

ConventionsConvenții

Conventions shared by every Fint endpoint: request format, the response envelope, error handling, and identifiers.

Convenții comune tuturor endpoint-urilor Fint: formatul cererii, envelopa de răspuns, gestionarea erorilor și identificatorii.

GeneralGenerale

• Content type: request bodies are JSON (Content-Type: application/json) unless noted.
• Tip de conținut: corpurile cererilor sunt JSON (Content-Type: application/json), dacă nu se specifică altfel.
• Envelope: responses use { "status", "msg", "reason", "data" }. On success, msg and reason are usually null.
• Envelopă: răspunsurile folosesc { "status", "msg", "reason", "data" }. La succes, msg și reason sunt de obicei null.
• Error handling: branch on the stable reason field (snake_case), not the human-readable msg.
• Gestionarea erorilor: ramifică pe câmpul stabil reason (snake_case), nu pe msg lizibil.
• Identifiers: resources are referenced by a public uid; internal numeric database ids are not exposed, except where explicitly documented (e.g. the id returned when creating a company API key).
• Identificatori: resursele sunt referite printr-un uid public; id-urile numerice interne din baza de date nu sunt expuse, cu excepția cazurilor documentate explicit (ex. id-ul returnat la crearea unei chei API de companie).

HTTP methods and URL structureMetode HTTP și structura URL

Fint follows one rule across every service so endpoints are predictable:

Fint respectă o singură regulă în toate serviciile, astfel încât endpoint-urile să fie previzibile:

• GET is used for reads and never takes a request body.
• GET este folosit pentru citiri și nu acceptă niciodată un corp de cerere.
• POST is used for actions and creates, and takes a JSON body. Service toggles such as services/activate stay POST; there are no PUT, PATCH or DELETE methods.
• POST este folosit pentru acțiuni și creări și acceptă un corp JSON. Comutările de serviciu precum services/activate rămân POST; nu există metode PUT, PATCH sau DELETE.

Where a value goes in the URL depends on what it is:

Locul unei valori în URL depinde de ce reprezintă:

• Path segment - the identity of a stored resource. A specific resource that Fint issued a uid for is addressed by that uid in the path: /v1/{service}/{collection}/{uid}. Examples: GET /v1/extrase/transaction/{uid}, GET /v1/efactura/document/{uid}, GET /v1/efactura/download/{uid}, and the /v1/organization/companies/{company}/… actions.
• Segment de cale - identitatea unei resurse stocate. O resursă specifică pentru care Fint a emis un uid este adresată prin acel uid în cale: /v1/{service}/{collection}/{uid}. Exemple: GET /v1/extrase/transaction/{uid}, GET /v1/efactura/document/{uid}, GET /v1/efactura/download/{uid} și acțiunile /v1/organization/companies/{company}/….
• Query string - everything else. Pagination (limit, offset), filters (type, status, from, to, q, accountUid) and representation options (the download type) go in the query string. Lookup inputs that are not a Fint uid also go there - for example Info CUI’s ?cui= and Schimb valutar’s ?from=&to=&date=, whose inputs are the values you are looking up, not resources Fint owns.
• Query string - tot restul. Paginarea (limit, offset), filtrele (type, status, from, to, q, accountUid) și opțiunile de reprezentare (parametrul type la descărcare) merg în query string. Valorile de căutare care nu sunt un uid Fint merg tot acolo - de exemplu ?cui= la Info CUI și ?from=&to=&date= la Schimb valutar, ale căror valori sunt ceea ce cauți, nu resurse deținute de Fint.

Error envelopeEnvelopă de eroare

All responses share a single JSON envelope. On errors, branch on the stable reason field rather than the human-readable msg.

Toate răspunsurile folosesc o singură envelopă JSON. La erori, ramifică pe câmpul stabil reason, nu pe msg lizibil.

{
  "status": "error",
  "msg": "A human-readable English sentence.",
  "reason": "stable_snake_case_identifier",
  "data": null
}

The /efactura/download endpoint is the exception on success: it streams a binary file instead of the envelope. Validation errors on /efactura/send include a data.errors[] array with per-field code, field and message.

Endpoint-ul /efactura/download este excepția la succes: transmite un fișier binar în loc de envelopă. Erorile de validare la /efactura/send includ un array data.errors[] cu code, field și message per câmp.

Request bodyCorpul cererii

• Content-Type: always Content-Type: application/json for POST requests.
• Content-Type: întotdeauna Content-Type: application/json pentru cererile POST.
• Root type: the body must be a JSON object ({…}). An empty object is accepted on endpoints that take no body.
• Tipul rădăcinii: corpul trebuie să fie un obiect JSON ({…}). Un obiect gol este acceptat pe endpoint-urile care nu necesită corp.
• Size limit: the eFactura /send endpoint enforces a 512 KiB maximum; larger bodies are rejected before JSON parsing.
• Limită de dimensiune: endpoint-ul eFactura /send impune un maximum de 512 KiB; corpurile mai mari sunt respinse înainte de parsarea JSON.

Malformed JSON returns 400 invalid_json. On the eFactura /send endpoint the response also carries a data.detail sub-code identifying the cause:

JSON-ul malformat returnează 400 invalid_json. Pe endpoint-ul eFactura /send răspunsul conține și un sub-cod data.detail care identifică cauza:

PaginationPaginare

List endpoints use offset-based pagination with two query parameters: limit (page size, default 50, max 100) and offset (rows to skip, default 0). The response always echoes both values back alongside a total count of all matching rows - use it to calculate whether more pages exist.

Endpoint-urile de listare folosesc paginare bazată pe offset cu doi parametri: limit (dimensiunea paginii, implicit 50, maxim 100) și offset (rânduri de sărit, implicit 0). Răspunsul returnează mereu ambele valori împreună cu un total al tuturor rândurilor care corespund - folosește-l pentru a calcula dacă mai există pagini.

{
  "status": "success",
  "msg": null,
  "reason": null,
  "data": {
    "documents": [
      "..."
    ],
    "total": 142,
    "limit": 50,
    "offset": 0
  }
}

Monetary amountsSume monetare

All monetary amounts in API responses are decimal strings, not JSON numbers - e.g. "121.00", not 121.00. This avoids the floating-point rounding errors that affect native floats in most languages (121.10 cannot be represented exactly in binary IEEE 754). Always parse monetary fields with your language’s decimal type (Decimal, BigDecimal, decimal.Decimal, etc.).

Toate sumele monetare din răspunsurile API sunt șiruri zecimale, nu numere JSON - ex. "121.00", nu 121.00. Aceasta evită erorile de rotunjire în virgulă mobilă care afectează float-urile native în majoritatea limbajelor (121.10 nu poate fi reprezentat exact în IEEE 754 binar). Parsează întotdeauna câmpurile monetare cu tipul zecimal al limbajului tău (Decimal, BigDecimal, decimal.Decimal etc.).

Two clarifications:

Două precizări:

• eFactura line-item echo fields (items[].price, items[].quantity, items[].vatRate) are JSON numbers, mirroring the numeric values you submit on /send. Computed monetary fields (total, items[].value, account balance, transaction amount) are always decimal strings.
• Câmpurile de linie eFactura reluate din cerere (items[].price, items[].quantity, items[].vatRate) sunt numere JSON, oglindind valorile numerice trimise la /send. Câmpurile monetare calculate (total, items[].value, balance pe conturi, amount pe tranzacții) sunt întotdeauna șiruri zecimale.
• Exchange rates (Schimb valutar rate) are JSON numbers - a rate is a ratio, not a monetary amount.
• Cursurile valutare (rate la Schimb valutar) sunt numere JSON - un curs este un raport, nu o sumă monetară.

Dates and timestampsDate și timestamp-uri

• Dates - calendar dates use YYYY-MM-DD (e.g. "2026-06-29"), both in query parameters and response fields such as documentDate, bookingDate, validUntil.
• Date calendaristice - folosesc formatul YYYY-MM-DD (ex. "2026-06-29"), atât în parametrii de interogare cât și în câmpurile de răspuns precum documentDate, bookingDate, validUntil.
• Timestamps - datetime fields use YYYY-MM-DD HH:MM:SS (e.g. "2026-06-29 10:00:00"), as in createdOn, updatedOn, expiresOn.
• Timestamp-uri - câmpurile datetime folosesc YYYY-MM-DD HH:MM:SS (ex. "2026-06-29 10:00:00"), ca în createdOn, updatedOn, expiresOn.

API root and version discoveryRădăcina API și descoperirea versiunilor

Both API hosts answer unauthenticated GET requests on their root and version paths, in the standard envelope, always 200:

Ambele hosturi API răspund la cereri GET neautentificate pe rădăcină și pe calea de versiune, în anvelopa standard, întotdeauna 200:

• GET https://api.fint.ro/ - lists the available API versions with their base URLs (data.versions, currently only v1).
• GET https://api.fint.ro/ - listează versiunile API disponibile cu URL-urile lor de bază (data.versions, momentan doar v1).
• GET https://api.fint.ro/v1 - lists every available endpoint of that version (data.endpoints).
• GET https://api.fint.ro/v1 - listează toate endpoint-urile disponibile ale versiunii (data.endpoints).

The same applies on the sandbox host (https://sandbox.fint.ro/ and https://sandbox.fint.ro/v1). These are stable, non-error targets - use them for uptime monitoring or client-side connectivity checks.

La fel și pe hostul sandbox (https://sandbox.fint.ro/ și https://sandbox.fint.ro/v1). Sunt ținte stabile, fără erori - folosește-le pentru monitorizarea uptime-ului sau verificări de conectivitate în client.

Unknown routesRute necunoscute

Any misspelled or non-existent path under /v1/ returns 404 not_found in the standard JSON envelope - never an HTML error page. It is safe to always parse Fint API responses as JSON.

Orice cale greșită sau inexistentă sub /v1/ returnează 404 not_found în envelopa JSON standard - niciodată o pagină de eroare HTML. Răspunsurile API Fint pot fi parsate întotdeauna ca JSON.

LimitsLimite

Fint applies two independent kinds of limit, and it helps to keep them apart. Technical limits shape each individual request (body size, page size) and protect the API from abuse (rate limiting). Billing limits are the monthly allowance your plan includes for each service. This page explains both and what happens when you reach them.

Fint aplică două tipuri independente de limită și e util să le ții separate. Limitele tehnice modelează fiecare cerere în parte (dimensiunea corpului, dimensiunea paginii) și protejează API-ul de abuz (rate limiting). Limitele de facturare reprezintă cota lunară inclusă în planul tău pentru fiecare serviciu. Această pagină le explică pe ambele și ce se întâmplă când le atingi.

Technical limitsLimite tehnice

These apply per request, on every service, regardless of plan.

Acestea se aplică per cerere, pe fiecare serviciu, indiferent de plan.

Rate limitingRate limiting

Fint enforces a rate limit per company key, per organization key and per client IP over a short rolling window. The thresholds are deliberately high: they exist only to stop deliberate flooding and never interfere with normal integration traffic. You do not need to tune your client to stay under a specific number - just avoid tight retry loops.

Fint aplică o limită de rată per cheie de companie, per cheie de organizație și per IP client, pe o fereastră scurtă glisantă. Pragurile sunt intenționat ridicate: există doar pentru a opri inundarea deliberată și nu interferează niciodată cu traficul normal de integrare. Nu e nevoie să-ți reglezi clientul pentru a rămâne sub un anumit număr - evită doar buclele agresive de reîncercare.

When the ceiling is exceeded, the API responds with 429 and reason: "rate_limited", plus a Retry-After header giving the number of seconds to wait. Honor it: pause for that long, then retry. The limiter is fail-open - if it ever cannot record a request, it allows the request rather than blocking legitimate traffic.

Când plafonul este depășit, API-ul răspunde cu 429 și reason: "rate_limited", plus un antet Retry-After care indică numărul de secunde de așteptat. Respectă-l: așteaptă acel interval, apoi reîncearcă. Limitatorul este fail-open - dacă vreodată nu poate înregistra o cerere, o permite în loc să blocheze traficul legitim.

Billing / usage limitsLimite de facturare / consum

Every service you activate on a company comes with a monthly included allowance, measured in that service’s natural unit:

Fiecare serviciu activat pe o companie vine cu o cotă lunară inclusă, măsurată în unitatea naturală a serviciului:

• eFactura - documents sent and retrieved.
• eFactura - documente trimise și preluate.
• Extrase - bank accounts kept enabled.
• Extrase - conturi bancare menținute active.
• Info CUI and Schimb valutar - API requests.
• Info CUI și Schimb valutar - cereri API.