French legal data

The legal_data module enriches a list of POI with official records from French public legal data sources. For each input row, the module queries the public company search service of api.gouv.fr (SIRENE data, registered executives, published financials) and complements the response with BODACC legal notices. The result is a structured profile attached to each company: legal form, registered executives, NAF code, headcount band, headline financials when published, and a consolidated lead status.

The module is read-only: no credentials are required, no fees are charged by the upstream sources, and no business is contacted as part of the lookup.

No website needed. Unlike legal_ids, which reads identifiers from a website, this module matches each row by name + address against SIRENE and also returns the SIRET/SIREN. Choose it when your list has no website column: for example a Google Maps scrape with names and map links only.

US listings. Rows located in the United States are matched against official US registers (federal registers in every state, state or city registers in 39 states), with different columns. Revenue only exists for listed companies. See "Listings located in the United States" below.

Purpose

French B2B prospecting lists tend to start with a name, an address, and maybe a website. legal_data turns each row into a qualified company record using only public registries.

Typical use cases:

• Filter a scraped list by capital, headcount band, or NAF code before outreach.
• Detect dead or insolvent entities (bodacc_procedure_collective) and drop them from a sequence.
• Identify companies with recent legal events (capital increase, executive change, address change) as opportunity signals.
• Recover named executives to personalize a first-touch email.

Inputs

legal_data is an enrichment module: it consumes an existing list of POI rather than producing one. The expected input is a poi_list, typically the output of a discovery job.

Match resolution follows three tiers, in order:

1. Exact SIREN lookup when the identifier is provided.
2. Fuzzy match on nom + code_postal.
3. Geographic fallback on coordinates within a small radius.

A row that cannot be resolved is returned with empty enrichment columns and an error code (see Errors).

Outputs

Each input row keeps its original columns and gains the columns below. Empty values stay empty: the module never fabricates a value.

lead_status encodes the combination of administrative state, BODACC signals and recency of legal events. The registry lists shorter signal names under produces (forme_juridique, ca, dirigeants, and so on); the columns above are the ones actually written to the file.

The file also carries detail columns: siret_siege, sigle, adresse_siege, the labels (nature_juridique_libelle, tranche_effectif_libelle, libelle_naf), anciennete_annees, dirigeants_count, dirigeant_tranche_age, ca_dernier_exercice, resultat_net_dernier_exercice, the BODACC details (bodacc_procedure_type, bodacc_procedure_date, bodacc_dernier_evenement_date, bodacc_dernier_evenement_type), lead_status_detail and match_confidence.

Listings located in the United States

The same module handles rows located in the United States. They are never sent to the French sources: they are matched against official US registers that are downloaded in bulk, queried locally and refreshed every week. There is nothing to configure: routing is done row by row, and a French list is processed exactly as described above.

Coverage

In all 50 states and the District of Columbia, the federal registers answer:

In 39 states, state, county or city registers published as open data are added (174 registers):

In the other states (Arizona, Idaho, Indiana, Kansas, Mississippi, New Hampshire, New Mexico, Rhode Island, South Carolina, South Dakota, Tennessee, Wisconsin), no state or city register is published as a free download with a right of commercial use: only the federal registers answer.

A register that forbids commercial use, requires an account or a payment, or whose state law forbids use for solicitation, is not loaded.

How a row is recognised as American

1. The upstream discovery job targeted the United States (country: "USA").
2. Otherwise, the row carries an explicit US country, or an address ending with a state and a ZIP code (", CA 90012").
3. Otherwise, a North American phone number confirmed by a US ZIP code or by the listing's coordinates.

A row carrying a siren or a siret is never treated as American. A job whose upstream discovery targeted another country contains no American row.

Matching

A listing is only compared with the registers of its own state and with the federal rows of that state. A register record is only attributed when it is confirmed:

• high: same name at the same address (same number, same street, same ZIP code), or same phone confirmed by the address or by the name;
• medium: identical name in the same ZIP code, without a matching address; or same phone and same address with no name link at all. In that second case the register designates the company answering at that number: the operator behind a sign, or the practice hosting a practitioner;
• otherwise the row stays empty (match_method = not_found).

A listing without an address (a tradesperson working at the customer's place, a service area) can only be matched through its phone number.

A closed record in a municipal business register designates an operator that has ceased, often the previous occupant under the same sign: it is never attributed. The row stays empty and lead_status_detail says so.

When several registers carry the same business, columns are merged: the company register comes first, then state and city licences, then federal registers. sources_donnees lists every register found.

Columns filled

Columns absent or empty in the United States

On a fully American job, a module column that no row fills is removed from the output. Input columns are never removed. On a job mixing French and American listings, every column stays.

• Revenue and net income of an unlisted company: no US register publishes them.
• siren, siret_siege, code_naf, libelle_naf, categorie_entreprise, nature_juridique_code, sigle, nombre_etablissements, flags_qualite: notions specific to French registers.
• dirigeant_tranche_age, adresse_siege: not carried.
• BODACC columns: BODACC only covers France.

Measured rates

Measured on 2 October 2026 on 7136 listings from real searches, located in 33 states (two trades per state, among restaurants, plumbers, dentists, auto repair shops, hair salons, general contractors, law firms). Registers added after that date are not counted: "yes" and "no" describe the registers loaded on the day of the measurement.

Detail by state (states with at least 100 listings measured):

In several states of the first list, the register loaded only covers one county, one city or one sector (for example the food establishments of a county). Outside that scope, a listing is only found through the federal registers: the last column shows it.

California, measured separately on 584 listings from five real searches (restaurants in Los Angeles, plumbers in San Diego, dentists in San Francisco, auto repair shops in Sacramento, roofers in Fresno): 359 listings matched (61.5%).

The rate depends on the state, the city and the trade: a city whose municipal register is loaded answers much better than a city covered by the federal registers alone.

Listings located in Vermont

From 28 December 2026, for a listing located in Vermont, the results file no longer contains personal email addresses (such as first.last@), the verification result attached to a removed address, or information derived from the phone number (line type, carrier, porting, reachability). The name, address, phone number, website, general contact addresses (info@, contact@) and official register data remain. No row is removed.

The rule applies to the results file, whichever module filled the column, and also to files already produced. It follows Vermont's data broker law (Act 138 of 2026), effective 1 January 2027.

Sources and notices

Every listing carries the name of the register it comes from (registre_source, sources_donnees).

• CC BY-SA licence: City of Montgomery, Business License.
• Creative Commons Attribution 4.0 licence: City of Alpharetta, Business Licenses (current) ; Iowa Secretary of State, Active Iowa Business Entities (Iowa Data Hub) ; Iowa Department of Inspections, Appeals, and Licensing, Active Iowa Construction Contractor Registrations (Iowa Data Hub) ; Iowa Department of Revenue, Retail Sales and Retail Use Business Registrations (Iowa Data Hub) ; Iowa Insurance Division, Insurance Producer Business Entities Licensed in Iowa (Iowa Data Hub) ; Iowa Department of Revenue, Iowa Lottery Retailer List (Iowa Data Hub) ; Iowa Department of Revenue, Iowa Liquor Stores (Iowa Data Hub) ; Iowa Insurance Division, Registered Retirement Facilities in Iowa (Iowa Data Hub) ; Iowa Data Hub, Iowa Certified Organic Farms and Businesses (USDA National Organic Program) ; Wake County Environmental Services, Restaurants in Wake County (permitted food establishments) ; Utah Department of Alcoholic Beverage Services (DABS), All Licenses (hosted by the Utah Geospatial Resource Center).
• PDDL 1.0 licence: City of Cambridge, Food Establishment Permits (Cambridge Open Data) ; City of Boston Licensing Board, Cannabis Active Licenses (Analyze Boston).
• ODbL 1.0 licence: City and County of Durham, Small Business Recovery Fund Applicants (Durham Open Data, ArcGIS Online) ; City of Cleveland, Department of Building and Housing, Active Contractor Registrations (Cleveland Open Data, ArcGIS Online) ; Vermont Department for Children and Families, Child Development Division, Child Care Provider Data ; Washington State Department of Licensing, Business Licenses Related to the Transportation Industry (data.wa.gov).
• Public Domain U.S. Government licence: Pennsylvania Department of Human Services, Licensed Personal Care Homes (data.pa.gov) ; Pennsylvania Department of Health, Medical Marijuana Dispensaries (data.pa.gov) ; Pennsylvania Game Commission, PALS Sales Outlets (data.pa.gov) ; Pennsylvania Departments of State and Health, Find Naloxone at a Pharmacy (data.pa.gov) ; Pennsylvania Department of Environmental Protection, Emissions Inventory System Facilities (data.pa.gov) ; Pennsylvania Department of Health, Nursing Homes (data.pa.gov).
• Public Domain licence: Washington State Liquor and Cannabis Board, Liquor Renewal and Cannabis Renewal notices (data.wa.gov) ; Public Health - Seattle & King County, Food Establishment Inspection Data (data.kingcounty.gov).
• Source: U.S. Small Business Administration ; Alcohol and Tobacco Tax and Trade Bureau (TTB) ; Centers for Medicare & Medicaid Services (CMS) ; U.S. Department of Labor, Mine Safety and Health Administration ; Health Resources and Services Administration (HRSA), Bureau of Primary Health Care ; City of Montgomery, Alabama (opendata.montgomeryal.gov) ; Miami-Dade County, gis-mdc.opendata.arcgis.com ; Macon-Bibb County Government ; Iowa Insurance Division, Iowa Data Hub (data.iowa.gov), CC BY 4.0 ; State of Iowa, Iowa Data Hub (data.iowa.gov), CC BY 4.0 ; Massachusetts Cannabis Control Commission ; City of Cambridge, Massachusetts ; City of Boston Licensing Board ; Prince George's County, Maryland (data.princegeorgescountymd.gov) ; Maine Bureau of Alcoholic Beverages and Lottery Operations (BABLO) ; City and County of Durham, North Carolina (Durham Open Data) ; Douglas County Health Department, Nebraska ; NYC Open Data, Department of Consumer and Worker Protection ; City of Cleveland, Department of Building and Housing (Cleveland Open Data) ; Pennsylvania Department of Human Services, data.pa.gov ; Pennsylvania Department of Health, data.pa.gov ; Pennsylvania Game Commission, data.pa.gov ; Pennsylvania Department of Environmental Protection, data.pa.gov ; Texas Department of Licensing and Regulation (TDLR), https://www.tdlr.texas.gov/LicenseSearch/licfile.asp ; Utah Department of Alcoholic Beverage Services (DABS) and Utah Geospatial Resource Center (UGRC), DABS All Licenses, licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Data modified: establishment licenses only, license type codes removed from names, columns renamed. ; Vermont Department for Children and Families (DCF), Child Development Division, Vermont Child Care Provider Data (https://data.vermont.gov/d/ctdw-tmfz) ; Washington State Department of Licensing, data.wa.gov ; Washington State Liquor and Cannabis Board, data.wa.gov ; Public Health - Seattle & King County, data.kingcounty.gov.
• U.S. Centers for Medicare & Medicaid Services, Nursing homes including rehab services (Provider Information) ; U.S. Centers for Medicare & Medicaid Services, Medical Equipment Suppliers (Medicare-enrolled DMEPOS suppliers): "Your materials, however, shouldn't give the false impression that the government's endorsing your commercial products or services. See 42 U.S.C 1320b-10"
• U.S. Department of Labor, Mine Safety and Health Administration, Mine Address of Record (mine operators): "However, such materials may not be used in a manner that implies any affiliation or endorsement by the DOL of your company, website or publication."
• Colorado Department of State, Business Entities in Colorado (Colorado Information Marketplace) ; Colorado Department of Revenue, Liquor Enforcement Division, Liquor Licenses in Colorado (Colorado Information Marketplace) ; Colorado Department of Early Childhood, Licensed Child Care Facilities Report (Colorado Information Marketplace) ; Boulder County Public Health, Restaurant Inspections in Boulder County 2025-present (Colorado Information Marketplace) ; Colorado Department of State, Trade Names for Businesses in Colorado (Colorado Information Marketplace): "The data made available here has been modified for use from its original source, which is the State of Colorado. THE STATE OF COLORADO MAKES NO REPRESENTATIONS OR WARRANTY AS TO THE COMPLETENESS, ACCURACY, TIMELINESS, OR CONTENT OF ANY DATA MADE AVAILABLE THROUGH THIS SITE. THE STATE OF COLORADO EXPRESSLY DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. The data is subject to change as modifications and updates are complete. It is understood that the information contained in the Web feed is being used at one's own risk."
• City of Chicago Business Licenses, Current Active: "This site provides applications using data that has been modified for use from its original source, www.cityofchicago.org, the official website of the City of Chicago. The City of Chicago makes no claims as to the content, accuracy, timeliness, or completeness of any of the data provided at this site. The data provided at this site is subject to change at any time. It is understood that the data provided at this site is being used at one's own risk."
• City of Boston Licensing Board, Cannabis Active Licenses (Analyze Boston): "City of Boston Terms of Use : « You and your application must not express or imply any sponsorship or endorsement by the City of Boston. »"
• Prince George's County, Maryland, licensed child care centers (OpenPGC): "The datasets, maps, and charts (the “Data”) made available for use, and download, through the data.mypgc.us website has been modified for use from its original source, which is Prince George’s County, Maryland (the “County”). Neither the County or its agencies make any claims as to the completeness, accuracy, timeliness, or content of any Data contained in or obtained from the data.mypgc.us website. THE COUNTY DISCLAIMS ALL WARRANTIES OR CONDITIONS, EXPRESSED OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE DATA.MYPGC.US WEBSITE AND ALL DATA FURNISHED THEREIN AND/OR OBTAINED THEREFROM. The Data is subject to modification and possible deletion as changes occur. It is understood that the Data and information contained in the data.mypgc.us website and web application is being used at one’s own risk."
• Maine Bureau of Alcoholic Beverages and Lottery Operations, Liquor License Data: "Maine.gov Link Policy : « You may not state or imply that the State of Maine, InforME, or Maine.gov is endorsing your product, site, or services. »"
• Missouri Division of Alcohol and Tobacco Control, Active Alcohol Licenses ; Missouri Department of Health and Senior Services, Licensed Lodging Establishments: "The data made available here has been modified for use from its original source, which is the State of Missouri. THE STATE OF MISSOURI MAKES NO REPRESENTATIONS OR WARRANTY AS TO THE COMPLETENESS, ACCURACY, TIMELINESS, OR CONTENT OF ANY DATA MADE AVAILABLE THROUGH THIS SITE. THE STATE OF MISSOURI EXPRESSLY DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. The data is subject to change as modifications and updates are complete. It is understood that the information contained in the Web feed is being used at one's own risk."
• City and County of Durham, Small Business Recovery Fund Applicants (Durham Open Data, ArcGIS Online): "Contains information from City and County of Durham's Small Business Recovery Fund Applicants, which is made available here under the Open Database License (ODbL)."
• City of Cleveland, Department of Building and Housing, Active Contractor Registrations (Cleveland Open Data, ArcGIS Online): "Contains information from City of Cleveland's Active Contractor Registrations, which is made available here under the Open Database License (ODbL)."
• Texas Department of Licensing and Regulation, License Data Files (establishments and contractors) ; Texas Department of Licensing and Regulation, License Data Files (licensed facilities and companies) ; Texas Department of Licensing and Regulation, License Data Files (tow companies and vehicle storage facilities): "Source: Texas Department of Licensing and Regulation, https://www.tdlr.texas.gov, copied on the date of the last refresh of this registry. Neither this site nor the information, as it is presented here, is endorsed by the State of Texas or any state agency."
• Utah Department of Alcoholic Beverage Services (DABS), All Licenses (hosted by the Utah Geospatial Resource Center): "The data, including but not limited to geographic data, tabular data, and analytical data, are provided “as is” and “as available”, with no guarantees relating to the availability, completeness, or accuracy of data, and without any express or implied warranties. These data are provided as a public service for informational purposes only. You are solely responsible for obtaining the proper evaluation of a location and associated data by a qualified professional. UGRC reserves the right to change, revise, suspend or discontinue published data and services without notice at any time. Neither UGRC nor the State of Utah are responsible for any misuse or misrepresentation of the data. UGRC and the State of Utah are not obligated to provide you with any maintenance or support. The user assumes the entire risk as to the quality and performance of the data. You agree to hold the State of Utah harmless for any claims, liability, costs, and damages relating to your use of the data. You agree that your sole remedy for any dissatisfaction or claims is to discontinue use of the data."
• Vermont Department for Children and Families, Child Development Division, Child Care Provider Data: "Contains information from Vermont Child Care Provider Data (https://data.vermont.gov/d/ctdw-tmfz), which is made available here under the Open Database License (ODbL) (https://opendatacommons.org/licenses/odbl/1-0/)."
• City of Tacoma, Tax and License, Business Licenses (active accounts, data.tacoma.gov): "The information and data made available here has been modified for use from its original source, which is the City of Tacoma. The City of Tacoma makes no claims as to the completeness, accuracy, or timeliness of any information and data contained in this application; makes no representation of any kind, including, but not limited to, warranty of the accuracy or fitness for a particular use; nor are any such warranties to be implied or inferred with respect to the information or data furnished herein. The information and data is subject to change without notice. It is understood that the information and data contained in the web site is being used at user’s own risk."
• Washington State Department of Licensing, Business Licenses Related to the Transportation Industry (data.wa.gov): "Contains information from Department of Licensing's Business Licenses Related to the Transportation Industry, which is made available here under the Open Database License (ODbL)."

Lifecycle

Standard job lifecycle. See Jobs lifecycle. Progress is reported per establishment processed. The job is idempotent within a session: re-running on the same input list yields the same enriched columns, modulo upstream registry updates.

Pipeline

needs:     poi_list
produces:  enriched_list

legal_data consumes a poi_list and emits an enriched_list carrying the original rows plus the columns described in Outputs. The enriched list can itself be consumed by downstream enrichment modules (legal_mentions, legal_ids, etc.).

Endpoints

Create a job

POST /api/jobs/legal-data

Request body:

{
  "items": [
    { "nom": "Boulangerie Martin", "code_postal": "75011" },
    { "siren": "552120222" }
  ],
  "source_job_id": "job_01HXYZ..."
}

Either items or source_job_id must be provided. When source_job_id references a completed discovery job, its rows are used as input directly.

Response: a Job resource with id, type, status, and progress fields.

Retrieve a job

GET /api/jobs/{job_id}

Returns the current state, progress counters, and (when done) the download URL for the enriched CSV.

List jobs

GET /api/jobs?type=legal_data

Maximum 5,000 rows per job. Larger lists must be split client-side. Global quotas and rate limits: see Limits.

Financial figures depend on the company having filed its accounts (roughly 60 percent of French SMEs). Executive names reflect the last filing; recent changes may take a few weeks to propagate.

Errors

Row-level errors are reported in an error column on the enriched output. Job-level errors transition the job to failed.

A source_unavailable failure preserves all rows already enriched before the outage. The job can be re-submitted with the remaining rows once the upstream source recovers.

What's next

• legal_ids: detect SIREN and SIRET identifiers directly on a company website, with Luhn validation. A useful prerequisite when input rows lack a siren.
• legal_mentions: parse the legal notice page of a website to extract registered name, capital, RCS, postal address, and VAT number. Complements legal_data when registry filings are sparse.