Skip to content
Skip the animation

Lumos API

Romanian tax calculations, scam checks, funding programs and court cases, as an API for apps and AI assistants.

In preparation · waiting list

Join the waiting list See the products
  • 4Lumos products
  • 18operations
  • 15MCP tools
  • 1key for all of them

You build the app. Lumos keeps the rules, the data and the checks up to date.

How it works

From account to first call, in four steps

Lumos API is not open yet. This is how it will work once you have access.

  1. Account

    You create an account for your company and choose the services you want to use.

  2. Key

    You get one key for testing and one for production. A key is shown only once, when you create it.

  3. Call

    You send a request from your app and get the result, ready to show.

  4. Usage

    You see what each call cost and how many credits you have left.

Not sure what an API is? Read it here, step by step.

Products

What you can use

4 Lumos products, with 18 operations and 15 tools for AI assistants at launch.

In preparation

TaxaRO

Calculates taxes and contributions for employees, sole proprietors (PFA), companies (SRL) and other income in Romania.

  • 6 operations
  • 6 MCP tools
  • 0–5 credits per call
See the operations
  • POST /v1/taxaro/calculationsCalculates taxes and contributions for employees, PFA, SRL, dividends, NGOs and other income.2 credits
  • POST /v1/taxaro/comparisonsCompares a PFA with an SRL for the same income.3 credits
  • POST /v1/taxaro/aggregationsFor several income sources: CAS and CASS on the total, income tax on each source.3 credits
  • POST /v1/taxaro/d212-mappingTells you what to fill in on the single tax return (D212), based on a calculation.5 credits
  • GET /v1/taxaro/deadlinesTax deadlines for a type of business or income.1 credit
  • GET /v1/taxaro/rulesThe rules version and the date it was updated, for each fiscal year.free
In preparation

Scam Alert

Checks whether a message, a link, a phone number or a website looks like a scam.

  • 4 operations
  • 4 MCP tools
  • 1 credit per call
See the operations
  • POST /v1/scam/checksChecks a text, a link or a number (up to 4000 characters) and returns a verdict, a score and the reasons.1 credit
  • GET /v1/scam/numbers/{number}The status of a phone number: reported or confirmed by the team.1 credit
  • GET /v1/scam/domains/{domain}The status of a domain: its age, whether it looks like a known brand, and whether it is confirmed.1 credit
  • GET /v1/scam/alertsActive alerts (the national cybersecurity agency, the community, our team).1 credit
In preparation

FonduRO

Search funding programs and see which ones fit your business, with the official source and the date it was checked.

  • 4 operations
  • 4 MCP tools
  • 1–3 credits per call
See the operations
  • GET /v1/fonduro/programsPublished funding programs, filtered by type of applicant, category, county, status and text.1 credit
  • GET /v1/fonduro/programs/{slug}The details of a program: amount, co-financing, eligibility, official source and the date it was checked.1 credit
  • POST /v1/fonduro/matchesThe programs that fit a profile (type, county, turnover, employees).3 credits
  • GET /v1/fonduro/calendarWhen calls open and when they close.1 credit
In preparation

DosaRO

Find a court case by its number and see its hearings and status.

  • 4 operations
  • 3 MCP tools
  • 0–3 credits per call
See the operations
  • POST /v1/dosaro/searches/by-numberEvery stage of a case number, with parties, hearings and appeals.3 creditscoming later
  • GET /v1/dosaro/cases/{case_id}One case (by the case_id you got from a search), with the date of its last update.2 creditscoming later
  • GET /v1/dosaro/cases/{case_id}/calendarThe case's upcoming hearings, in .ics (calendar) format.1 creditcoming later
  • GET /v1/dosaro/portal-statusWhether the courts' portal is answering right now.free

What comes next

15 more products on the way

After the first four we are preparing these too, one at a time.

In preparation

Anticipat

Financial calculators for loans, with a PDF report.

  • 2 operations
  • 2–10 credits per call
See the operations
  • POST /v1/anticipat/calculationsThe result of one of the calculators, for the data you enter.2 credits
  • POST /v1/anticipat/reportsA PDF report for a calculation.10 credits
In preparation

EduFin

Financial education in plain language: a glossary, lessons and a quiz.

  • 3 operations
  • 1–2 credits per call
See the operations
  • GET /v1/edufin/glossaryThe financial glossary terms, in Romanian and English.1 credit
  • GET /v1/edufin/lessonsThe levels and lessons, without the quizzes' correct answers.1 credit
  • POST /v1/edufin/assessmentsScores a quiz; the correct answers are never sent in advance.2 credits
In preparation

Cerere · request templates

Generates letters and applications to institutions from ready-made templates, filled in with your data.

  • 2 operations
  • 1–5 credits per call
See the operations
  • GET /v1/cerere/templatesThe list of request templates, with the fields each one needs.1 credit
  • POST /v1/cerere/documentsGenerates the document from a template and the data you send.5 credits
In preparation

Lumos Studio physical services

Ask for a quote, place an order and follow its progress, for 3D printing, laser engraving or DTF printing.

  • 4 operations
  • 0–3 credits per call
See the operations
  • GET /v1/services/physicalThe physical services available and their parameters.free
  • POST /v1/quotesA quote for a service (material, size, quantity, files).2 credits
  • POST /v1/ordersAn order placed from an accepted quote.3 credits
  • GET /v1/orders/{id}The order's status: received, in progress, ready, shipped.1 credit
In preparation

89 · Romania before and after 1989

Wages, prices and other indicators from the last decades, with the source and a confidence level on every figure. Free.

  • 2 operations
  • free
See the operations
  • GET /v1/89/indicatorsThe list of indicators, with licence, source and confidence level.free
  • GET /v1/89/indicators/{id}The series of one indicator: year, value, source and confidence.free
In preparation

AirSpot · drone flight zones

Where you may fly a drone in Romania, which restrictions apply at a point on the map and what the weather is like for flying.

  • 3 operations
  • 1 credit per call
See the operations
  • GET /v1/airspot/zonesRomania's flight zones (GeoJSON), with the date they were read.1 credit
  • POST /v1/airspot/zone-statusWhich zones a point is in and what restrictions they carry.1 credit
  • GET /v1/airspot/weatherThe weather that matters for flying at a point.1 credit
In preparation

Explore Dacia · historic places

Sites from Romania's history, with coordinates, description and source, plus timelines by period and theme.

  • 2 operations
  • 1 credit per call
See the operations
  • GET /v1/explore/placesHistoric places with coordinates, description and source.1 credit
  • GET /v1/explore/timelinesTimelines by period and theme.1 credit
In preparation

Lumos Learn

Lessons about artificial intelligence, by path and level, a prompt library and a directory of tools, as data for education platforms and AI assistants.

  • 3 operations
  • 1 credit per call
See the operations
  • GET /v1/learn/lessonsLessons by path and level.1 credit
  • GET /v1/learn/promptsThe prompt library, with categories.1 credit
  • GET /v1/learn/toolsThe directory of AI tools.1 credit
In preparation

Lumos Crypto · glossary

The terms of the cryptocurrency world, explained so anyone can follow.

  • 1 operation
  • 1 credit per call
See the operations
  • GET /v1/crypto/glossaryTerms explained so anyone can follow.1 credit
In preparation

Company profile

Send a tax ID and get the company's tax status, its financial statements by year and its trade register data, each with its source and date. Companies only, not individuals.

  • 4 operations
  • 1–3 credits per call
See the operations
  • GET /v1/firma/{cui}/statusA company's tax status: VAT, inactive or not, registered in e-Factura.1 credit
  • GET /v1/firma/{cui}/financialsTurnover, profit, debts and number of employees, by year, from the filed financial statements.2 credits
  • GET /v1/firma/searchSearch companies by name, locality or field of activity (CAEN).1 credit
  • GET /v1/firma/{cui}All together: tax status, financial statements and register data, in one call.3 credits
In preparation

e-Factura validation

Send an invoice as XML and find out whether it passes validation. If it does not, you get the error explained in plain language.

  • 1 operation
  • 2 credits per call
See the operations
  • POST /v1/efactura/validationsValidates an invoice XML and explains the errors, if any.2 credits
In preparation

Validators and utilities

Small, fast checks for your app: tax ID (CUI), Romanian IBAN, localities and counties, CAEN codes, working days and public holidays. Free, within limits.

  • 5 operations
  • free
See the operations
  • POST /v1/validatori/cuiChecks whether a tax ID (CUI) has the correct form.free
  • POST /v1/validatori/ibanChecks whether a Romanian IBAN has the correct form (structure and check digits).free
  • GET /v1/validatori/localitatiSearch localities and counties by name, with their official code (SIRUTA).free
  • GET /v1/validatori/caenLook up a CAEN code by number or name.free
  • GET /v1/validatori/zile-lucratoareWorking days and public holidays in a period.free
In preparation

Alerts and monitoring

Tell us which companies or programs interest you and get notified when something changes: a company's tax status, a new financial statement or a matching funding call.

  • 4 operations
  • 0–2 credits per call
See the operations
  • POST /v1/alerte/watchesCreate a watch for a company or for a type of funding program.2 credits
  • GET /v1/alerte/watchesThe list of your watches.free
  • POST /v1/alerte/watches/{id}/stopStop a watch.free
  • GET /v1/alerte/eventsWhat changed since the last check.1 credit
In preparation

Public contracts

See which contracts a company has won from the state and what an institution has bought, from the open public procurement data. Updated quarterly.

  • 2 operations
  • 2 credits per call
See the operations
  • GET /v1/contracte/firma/{cui}The public contracts signed by a company: institution, value and date.2 credits
  • GET /v1/contracte/searchSearch contracts by institution, field (CPV code) or value.2 credits

Example

What a call looks like

Pick an example and a programming language. In the response you see the result, the cost in credits and the rules version.

curl https://api.lumosstudio.ro/v1/taxaro/calculations \
  -H "Authorization: Bearer $LUMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form":"pfa_real","annual_income":120000,"expenses":30000,"has_employment_contract":false,"locale":"en"}'
← 200 OK
{
  "data": {
    "form": "pfa_real",
    "tax_year": 2026,
    "currency": "RON",
    "gross_income": 120000,
    "net_income": 90000,
    "total_taxes": 28035,
    "net_take_home": 61965,
    "effective_rate": 0.233625,
    "breakdown": [
      {
        "key": "impozit",
        "label": "Income tax (10%)",
        "amount": 6885
      },
      {
        "key": "cas",
        "label": "CAS, pension (25%)",
        "amount": 12150
      },
      {
        "key": "cass",
        "label": "CASS, health (10%)",
        "amount": 9000
      }
    ]
  },
  "meta": {
    "request_id": "req_01J9Z6K3N8X2",
    "environment": "test",
    "credits_charged": 2,
    "credits_remaining": 98,
    "rules_version": "taxaro-2026.10.14",
    "disclaimer": {
      "code": "fiscal_calculation",
      "text": "Indicative information, not tax advice."
    }
  }
}

An example with fixed data: nothing is sent from here. The figures are calculated by the products’ real rules.

MCP

For AI assistants

MCP is how an AI assistant, such as Claude, uses outside services. The operations of the API are MCP tools too, and they cost the same.

You

How much do I keep if I am a sole proprietor (PFA) with 120,000 lei income and 30,000 lei expenses?

The assistant uses a tooltaxaro_calculate({ form: "pfa_real", annual_income: 120000, expenses: 30000 })→ total_taxes 28035 · net_take_home 61965 · rules_version taxaro-2026.10.14 · 2 credits
The assistant

You keep about 61,965 lei after income tax, CAS and CASS (28,035 lei in total). An indicative calculation, not tax advice.

An example conversation. The figures are calculated by TaxaRO.

15 tools at launch

  • taxaro_calculateTaxaRO · 2
  • taxaro_compare_pfa_srlTaxaRO · 3
  • taxaro_aggregate_incomesTaxaRO · 3
  • taxaro_d212_fieldsTaxaRO · 5
  • taxaro_deadlinesTaxaRO · 1
  • taxaro_rules_versionTaxaRO · free
  • scam_check_textScam Alert · 1
  • scam_lookup_numberScam Alert · 1
  • scam_lookup_domainScam Alert · 1
  • scam_list_alertsScam Alert · 1
  • fonduro_search_programsFonduRO · 1
  • fonduro_get_programFonduRO · 1
  • fonduro_match_programsFonduRO · 3
  • fonduro_deadlinesFonduRO · 1
  • dosaro_portal_statusDosaRO · free

You connect with an API key. Later you will also be able to use a Lumos account, straight from your AI app.

Credits

You pay in credits, not in a subscription

You buy credits in advance and get a few free ones every month. Every operation costs a fixed number of credits. When they run out, calls stop.

100 credits left of the 100 free ones each month

  • Press an operation and watch the credits go down.

Just a demonstration: no API is called. The price of a credit has not been set yet.

Trust

What we promise

We tell you how recent the data is

Every response shows the version of the rules it used and when the data was last updated.

Indicative, not advice

Tax calculations, legal information and funding information are indicative. Every response comes with a notice that you can show to your users.

We do not keep what you send

We do not save the data in your requests. We keep only who made the call, which operation it was, what it cost and how long it took.

A separate test environment

Test keys, credits and data are kept apart from the real ones, so you can try things out without risk or cost.

Waiting list

Tell me when it opens

We write to you once, when you can start using Lumos API. We send no other messages.