Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional ISO date 'YYYY-MM-DD': keep only companies registered on or after that day, inclusive, on the registry date (firme.data_inmatriculare).",
+  "title": "Registered Since"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional ISO date 'YYYY-MM-DD': keep only companies registered on or before that day, inclusive. With registered_since, a window.",
+  "title": "Registered Until"
+}

Previous value: -"Default true: drop firms that are not a lead (struck off, dissolving, in liquidation, insolvent or bankrupt, activity suspended, or ANAF fiscally inactive). false returns every firm."New value: +"Default true: drop companies that are not a lead (struck off, dissolving, in liquidation, insolvent or bankrupt, activity suspended, or ANAF fiscally inactive). false returns every company."

Previous value: -"Optional county to narrow to (diacritic-insensitive: 'bucuresti', 'cluj'; a county town such as 'Cluj-Napoca' or a Bucharest sector is read as its county); omit for nationwide. An unknown county is an error (unknown_county) with suggestions, not 0 firms."New value: +"Optional county to narrow to (diacritic-insensitive: 'bucuresti', 'cluj'; a county town such as 'Cluj-Napoca' or a Bucharest sector is read as its county); omit for nationwide. An unknown county is an error (unknown_county) with suggestions, not 0 companies."

Previous value: -"true keeps only firms with a website on file in the registry (default false)."New value: +"true keeps only companies with a website on file in the registry (default false)."

Previous value: -"Default false: a firm matches when the code is ANY of its authorised activities (ONRC lists a dozen per firm, most never practised). true keeps only firms whose DECLARED main activity is one of the codes (ANAF main CAEN, else the CAEN on the latest filing): fewer, more relevant firms. The Leadgen app's lists use true by default."New value: +"Default false: a company matches when the code is ANY of its authorised activities (ONRC lists a dozen per company, most never practised). true keeps only companies whose DECLARED main activity is one of the codes (ANAF main CAEN, else the CAEN on the latest filing): fewer, more relevant companies. The Leadgen app's lists use true by default."

Previous value: -"Optional minimum net turnover in RON on the latest filing (FY2025, else FY2024). Firms without a filing never match a band."New value: +"Optional minimum net turnover in RON on the latest filing (FY2025, else FY2024). Companies without a filing never match a band."

Previous value: -"Order of the results: 'newest' registrations first (default), 'revenue' (latest filing's turnover, biggest first) or 'employees' (headcount, biggest first); firms without a filing come last."New value: +"Order of the results: 'newest' registrations first (default), 'revenue' (latest filing's turnover, biggest first) or 'employees' (headcount, biggest first); companies without a filing come last."

Previous value: -"What the firms do: a curated topic ('software', 'retail'), plain words for a trade ('dentists', 'stomatologie'), a CAEN class title in Romanian or English, or CAEN codes ('6201' or '4321,4322'). Case-, space- and diacritic-insensitive. A number that names another activity in each revision takes a suffix: '4781r3' (Rev.3) or '4781r2' (Rev.2)."New value: +"What the companies do: a curated topic ('software', 'retail'), plain words for a trade ('dentists', 'stomatologie'), a CAEN class title in Romanian or English, or CAEN codes ('6201' or '4321,4322'). Case-, space- and diacritic-insensitive. A number that names another activity in each revision takes a suffix: '4781r3' (Rev.3) or '4781r2' (Rev.2)."

Previous value: -"Optional: true keeps VAT-registered firms only, false only non-VAT payers (ANAF data). Omit for both."New value: +"Optional: true keeps VAT-registered companies only, false only non-VAT payers (ANAF data). Omit for both."

Previous value: -"A lead list: firms in an activity, newest registration first (or by turnover / headcount: sort)."New value: +"A lead list: companies in an activity, newest registration first (or by turnover / headcount: sort)."

Previous value: -"Firms removed by active_only (null when off)."New value: +"Companies removed by active_only (null when off)."

Previous value: -"How many firms the whole list holds with every filter (active_only on; null when off): exact, or estimated when matchTotalApproximate is true."New value: +"How many companies the whole list holds with every filter (active_only on; null when off): exact, or estimated when matchTotalApproximate is true."

Previous value: -"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address (a sole trader's PFA/II/IF locality only in an answer listing several firms, with addressScope: locality), county, city, website, phone (+ phoneSource: ANAF, declared by the taxpayer), caenActivities [{code, activity (RO), activityEn}], directors, representatives [{name, role}], status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, url (the firm's public record page to share with the user; null for sole traders and other natural persons), and score/match on name searches. With fields or compact, only the requested keys (compact keeps url)."New value: +"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address (a sole trader's PFA/II/IF locality only in an answer listing several companies, with addressScope: locality), county, city, website, phone as declared (+ phoneSource: ANAF, declared by the taxpayer; phoneStatus: valid, corrected with phoneSuggestion, or unverified: check before calling), caenActivities [{code, activity (RO), activityEn}], directors, representatives [{name, role}], status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, url (the company's public record page to share with the user; null for sole traders and other natural persons), and score/match on name searches. With fields or compact, only the requested keys (compact keeps url)."

Added value: +{
+  "description": "The warnings that have a machine-readable form (the CAEN Rev.2/Rev.3 notes): [{code, params, message}], message the same English line as in warnings; null when none.",
+  "items": {
+    "type": "object"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

Previous value: -"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address, county, city, website, phone, caenActivities [{code, activity (RO), activityEn}], directors, representatives [{name, role}], status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, url (the firm's public record page to share with the user; null for sole traders and other natural persons), and score/match on name searches. With fields or compact, only the requested keys (compact keeps url)."New value: +"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address (a sole trader's PFA/II/IF locality only in an answer listing several firms, with addressScope: locality), county, city, website, phone (+ phoneSource: ANAF, declared by the taxpayer), caenActivities [{code, activity (RO), activityEn}], directors, representatives [{name, role}], status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, url (the firm's public record page to share with the user; null for sole traders and other natural persons), and score/match on name searches. With fields or compact, only the requested keys (compact keeps url)."

Added value: +{
+  "description": "Rows in results. Every list answer carries it with this one meaning.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"Rows returned in this answer (at most max_results), not the size of the match set: a full page (total == max_results) may have more; narrow the filters or raise max_results."New value: +"Rows returned in this answer (at most max_results), not the size of the match set: a full page (total == max_results) may have more; narrow the filters or raise max_results. The same as returned; the size of the whole list is matchTotal."

Previous value: -"true keeps firms whose declared main activity (ANAF main CAEN, else the CAEN on the latest filing) is one of the codes, instead of any authorised activity (default false)."New value: +"Default false: a firm matches when the code is ANY of its authorised activities (ONRC lists a dozen per firm, most never practised). true keeps only firms whose DECLARED main activity is one of the codes (ANAF main CAEN, else the CAEN on the latest filing): fewer, more relevant firms. The Leadgen app's lists use true by default."

Added value: +{
+  "default": "newest",
+  "description": "Order of the results: 'newest' registrations first (default), 'revenue' (latest filing's turnover, biggest first) or 'employees' (headcount, biggest first); firms without a filing come last.",
+  "enum": [
+    "newest",
+    "revenue",
+    "employees"
+  ],
+  "title": "Sort",
+  "type": "string"
+}

Previous value: -"A lead list: firms in an activity, newest registration first."New value: +"A lead list: firms in an activity, newest registration first (or by turnover / headcount: sort)."

Added value: +{
+  "description": "The CAEN codes as asked, named: [{code, title (Romanian), titleEn}].",
+  "type": [
+    "array",
+    "null"
+  ]
+}

Added value: +{
+  "description": "How many firms the whole list holds with every filter (active_only on; null when off): exact, or estimated when matchTotalApproximate is true.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "description": "true when matchTotal is estimated (matchTotalMargin: its 99% margin).",
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The 99% margin of an estimated matchTotal.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address, county, city, website, phone, caenActivities [{code, activity}], directors, status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, url (the firm's public record page to share with the user; null for sole traders and other natural persons), and score/match on name searches. With fields or compact, only the requested keys (compact keeps url)."New value: +"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address, county, city, website, phone, caenActivities [{code, activity (RO), activityEn}], directors, representatives [{name, role}], status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, url (the firm's public record page to share with the user; null for sole traders and other natural persons), and score/match on name searches. With fields or compact, only the requested keys (compact keeps url)."

Added value: +{
+  "description": "The order of results: newest, revenue or employees.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Optional: true keeps a short preset per row (name, CUI, county, city, legal form, risk level, phone, website, latest revenue and headcount, record url)."New value: +"Optional: true keeps a short preset per row (name, CUI, county, city, legal form, risk level and what it did not check, phone, website, latest revenue and headcount, record url)."

Previous value: -"Optional county name to narrow to (diacritic-insensitive: 'bucuresti', 'cluj'); omit for nationwide."New value: +"Optional county to narrow to (diacritic-insensitive: 'bucuresti', 'cluj'; a county town such as 'Cluj-Napoca' or a Bucharest sector is read as its county); omit for nationwide. An unknown county is an error (unknown_county) with suggestions, not 0 firms."

Added value: +{
+  "description": "Each curated topic id with its name, e.g. {\"agriculture\": \"Agriculture & Food\"}, next to availableTopics.",
+  "type": [
+    "object",
+    "null"
+  ]
+}

Previous value: -"The curated topics, when the topic is unknown."New value: +"The curated topic ids, when the topic is unknown or ambiguous."

Previous value: -"Number of companies returned."New value: +"Rows returned in this answer (at most max_results), not the size of the match set: a full page (total == max_results) may have more; narrow the filters or raise max_results."

Previous value: -"true when more firms match than were returned."New value: +"true when max_results was cut to the list cap (and the list is full)."

Previous value: -"Optional: true keeps a short preset per row (name, CUI, county, city, legal form, risk level, phone, website, latest revenue and headcount)."New value: +"Optional: true keeps a short preset per row (name, CUI, county, city, legal form, risk level, phone, website, latest revenue and headcount, record url)."

Added value: +{
+  "description": "The same list opened in the Leadgen app (CAEN codes, county, legal form, active and main-activity filters), to share with the user; null when the app cannot open it (more than 10 codes, a legal form it does not offer).",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address, county, city, website, phone, caenActivities [{code, activity}], directors, status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, and score/match on name searches. With fields or compact, only the requested keys."New value: +"A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address, county, city, website, phone, caenActivities [{code, activity}], directors, status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, url (the firm's public record page to share with the user; null for sole traders and other natural persons), and score/match on name searches. With fields or compact, only the requested keys (compact keeps url)."

Added value: +"Default true: drop firms that are not a lead (struck off, dissolving, in liquidation, insolvent or bankrupt, activity suspended, or ANAF fiscally inactive). false returns every firm."

Added value: +"Optional county name to narrow to (diacritic-insensitive: 'bucuresti', 'cluj'); omit for nationwide."

Added value: +"true keeps only firms with a website on file in the registry (default false)."

Added value: +"Optional legal form(s) to keep, comma-separated, case-insensitive: 'SRL', 'SA', 'PFA', 'II', or 'SRL,SA' (companies, no sole traders). Default: any form."

Added value: +"true keeps firms whose declared main activity (ANAF main CAEN, else the CAEN on the latest filing) is one of the codes, instead of any authorised activity (default false)."

Added value: +"Optional maximum average headcount on the latest filing."

Added value: +"Maximum number of companies to return (1-100, default 10)."

Added value: +"Optional maximum net turnover in RON on the latest filing."

Added value: +"Optional minimum average headcount on the latest filing."

Added value: +"Optional minimum net turnover in RON on the latest filing (FY2025, else FY2024). Firms without a filing never match a band."

Added value: +"What the firms do: a curated topic ('software', 'retail'), plain words for a trade ('dentists', 'stomatologie'), a CAEN class title in Romanian or English, or CAEN codes ('6201' or '4321,4322'). Case-, space- and diacritic-insensitive. A number that names another activity in each revision takes a suffix: '4781r3' (Rev.3) or '4781r2' (Rev.2)."

Added value: +"Optional: true keeps VAT-registered firms only, false only non-VAT payers (ANAF data). Omit for both."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A lead list: firms in an activity, newest registration first.",
+  "properties": {
+    "asOf": {
+      "description": "What to cite: registry (ONRC snapshot date), financialYear (fiscal year of the figures), anaf (day of the ANAF data), snapshot, published, source.",
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "attribution": {
+      "description": "The credit line to keep when redistributing the data (CC BY 4.0).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "availableTopics": {
+      "description": "The curated topics, when the topic is unknown.",
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "caenCodes": {
+      "description": "The CAEN codes searched, when given or derived as codes.",
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "candidates": {
+      "description": "When the words fit several activities (ambiguous_topic): the ones to choose from.",
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "codesAdded": {
+      "description": "CAEN Rev.2/Rev.3 counterparts added to the search.",
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "county": {
+      "description": "The county filter, if any.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "error": {
+      "description": "Set only when there is no answer (empty_query, invalid_cui, data_unavailable, plan_required ...); such a call is not counted.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "fields": {
+      "description": "The company fields kept when fields or compact trimmed the rows.",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "filters": {
+      "description": "The filters applied (legalForm, activeOnly, revenue and headcount bands, vatPayer, mainActivityOnly ...).",
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "inactiveFilteredOut": {
+      "description": "Firms removed by active_only (null when off).",
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "inactiveFilteredOutApproximate": {
+      "description": "true when that count is estimated.",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "label": {
+      "description": "Human label of what was matched.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "matched": {
+      "description": "How plain words were read: by, niche or class title, codes.",
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "message": {
+      "description": "A sentence for the caller.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "query": {
+      "description": "The topic as given.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "results": {
+      "description": "The company records, best first.",
+      "items": {
+        "additionalProperties": true,
+        "description": "A company record: companyName, cui, registrationCode, registrationDate (DD/MM/YYYY), legalForm, euid, address, county, city, website, phone, caenActivities [{code, activity}], directors, status [{code, name}], latestFinancials {year, revenue, netResult, employees; RON}, anaf {mainCaen, vatPayer, eFactura, inactive}, risk {level, label, reasons, isLead}, source, asOf, and score/match on name searches. With fields or compact, only the requested keys.",
+        "type": "object"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "source": {
+      "description": "Data source: onrc (registry) or mfp (Ministry of Finance filings).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "topic": {
+      "description": "The curated topic matched, if any.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "total": {
+      "description": "Number of companies returned.",
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "truncated": {
+      "description": "true when more firms match than were returned.",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "warnings": {
+      "description": "Notes on how the request was read (a clamped limit, a widened CAEN code, an ignored field).",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "default": false,
+  "description": "Optional: true keeps a short preset per row (name, CUI, county, city, legal form, risk level, phone, website, latest revenue and headcount).",
+  "title": "Compact",
+  "type": "boolean"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional: keep only these company fields in each row, comma-separated (companyName,cui,county,risk; dotted paths such as risk.level work). Without it the full record is returned.",
+  "title": "Fields"
+}

Added value: +{
+  "default": false,
+  "title": "Main Activity Only",
+  "type": "boolean"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Max Employees"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Max Revenue"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Min Employees"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Min Revenue"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Vat Payer"
+}

Added value: +{
+  "default": true,
+  "title": "Active Only",
+  "type": "boolean"
+}

Added value: +{
+  "default": false,
+  "title": "Has Website",
+  "type": "boolean"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Legal Form"
+}