Vai al contenuto
Floweet
Accesso professionisti

Companies (SIRENE directory)

Search an establishment by name, SIREN or SIRET, and read its legal unit, activity, brand network and the estimate of its vehicle fleet.

api.floweet.com/v1 · Contract 1.0.0-beta.1 · Beta

This documentation is written in English and French; it is shown to you in English.

Sections · Companies
On this page
  1. Good to know
  2. Example: qualifying a prospect
  3. Source and reuse
  4. The CompanySearch object
  5. The CompanyHit object
  6. The CompanyDetail object
  7. Search the French business directory (SIRENE, 16.8 million establishments)
  8. An establishment: legal unit, activity, estimated fleet, franchise network

The directory of French establishments, from INSEE's SIRENE register: search an establishment by brand name, legal name, SIREN or SIRET, then read its detail — activity, legal unit, the brand network it belongs to, and the estimate of its vehicle fleet.

Good to know

  • fleetEstimate is an estimate: a model crosses the business sector (NAF code) with the headcount band reported to SIRENE. It is never actual data about the company's vehicles; present it as an order of magnitude (min, mid, max) with its confidence.
  • Search answers { results }, up to limit results (100 at most), without a cursor: narrow it with naf (code or division) and department. Closed establishments are left out, unless includeClosed=true.
  • franchise describes the establishment's brand network (establishments, active ones, departments covered); siblings counts the other establishments of the same legal unit.
  • A SIRET missing from the register answers 404 sirene_not_found. NAF codes are written with their dot (49.41A).

Example: qualifying a prospect

Search the company by name and department, read its detail by SIRET, then pass the fleet estimate to the fleet cost computation to price its overspend at the pump. Save the result as a prospect to get it back recomputed every week.

Source and reuse

INSEE SIRENE register (public data). The fleet estimate is computed by Floweet and must be presented as such.

The CompanySearch object

FieldTypeDescription
resultsalways presentCompanyHit[]
CompanySearch
{
  "results": [
    {
      "siret": "84983050000013",
      "siren": "849830500",
      "name": "TS TRANSPORTS",
      "legalName": "TS TRANSPORTS",
      "naf": "49.41A",
      "address": "111 AVENUE ALEXANDER FLEMING",
      "postalCode": "69300",
      "city": "CALUIRE-ET-CUIRE",
      "department": "69",
      "location": {
        "lat": 45.7936248779297,
        "lng": 4.84831619262695
      },
      "headOffice": true,
      "active": true
    },
    {
      "siret": "85183625400017",
      "siren": "851836254",
      "name": "TRANSPORTS TR",
      "legalName": "TRANSPORTS TR",
      "naf": "49.32Z",
      "address": "227 RUE DU GENERAL DE GAULLE",
      "postalCode": "69530",
      "city": "BRIGNAIS",
      "department": "69",
      "location": {
        "lat": 45.6660766601562,
        "lng": 4.75257873535156
      },
      "headOffice": true,
      "active": true
    }
  ]
}

The CompanyHit object

FieldTypeDescription
siretalways presentstring
sirenalways presentstring
namealways presentstring | nullBrand name, else legal name.
legalNamealways presentstring | null
nafalways presentstring | null
addressalways presentstring | null
postalCodealways presentstring | null
cityalways presentstring | null
departmentalways presentstring | null
locationalways presentobject | null
location.latalways presentnumber
location.lngalways presentnumber
headOfficealways presentboolean
activealways presentboolean
CompanyHit
{
  "siret": "84983050000013",
  "siren": "849830500",
  "name": "TS TRANSPORTS",
  "legalName": "TS TRANSPORTS",
  "naf": "49.41A",
  "address": "111 AVENUE ALEXANDER FLEMING",
  "postalCode": "69300",
  "city": "CALUIRE-ET-CUIRE",
  "department": "69",
  "location": {
    "lat": 45.7936248779297,
    "lng": 4.84831619262695
  },
  "headOffice": true,
  "active": true
}

The CompanyDetail object

FieldTypeDescription
establishmentalways presentany
nafLabelalways presentstring | null
legalUnitalways presentobject | null
legalUnit.sirenalways presentstring
legalUnit.namealways presentstring | null
legalUnit.legalFormalways presentstring | null
legalUnit.nafalways presentstring | null
legalUnit.nafLabelalways presentstring | null
legalUnit.headcountBandalways presentstring | null
legalUnit.createdOnalways presentstring | null
legalUnit.activealways presentboolean | null
fleetEstimatealways presentobject | nullESTIMATED mobile fleet (NAF sector × SIRENE headcount model), never actual data.
fleetEstimate.minalways presentnumber
fleetEstimate.maxalways presentnumber
fleetEstimate.midalways presentnumber
fleetEstimate.vehicleTypealways present"heavy_truck" | "van" | "car" | "bus" | "specialized" | "mixed"
fleetEstimate.confidencealways present"medium" | "low"
franchisealways presentobject | null
franchise.namealways presentstring
franchise.establishmentsalways presentinteger
franchise.activealways presentinteger
franchise.departmentsalways presentinteger
siblingsalways presentintegerat least 0Other establishments of the same legal unit.
CompanyDetail
{
  "establishment": {
    "siret": "84983050000013",
    "siren": "849830500",
    "name": "TS TRANSPORTS",
    "legalName": "TS TRANSPORTS",
    "naf": "49.41A",
    "address": "111 AVENUE ALEXANDER FLEMING",
    "postalCode": "69300",
    "city": "CALUIRE-ET-CUIRE",
    "department": "69",
    "location": {
      "lat": 45.7936248779297,
      "lng": 4.84831619262695
    },
    "headOffice": true,
    "active": true,
    "headcountBand": "NN",
    "updatedOn": "2025-12-05"
  },
  "nafLabel": "Transports routiers de fret interurbains",
  "legalUnit": null,
  "fleetEstimate": {
    "min": 1,
    "max": 2,
    "mid": 1,
    "vehicleType": "heavy_truck",
    "confidence": "low"
  },
  "franchise": null,
  "siblings": 0
}

Search the French business directory (SIRENE, 16.8 million establishments)

GET/v1/companiesScope companies:read

Parameters

FieldInTypeDescription
qrequiredquerystring2 to 200 charactersBrand or company name, SIREN or SIRET.
nafoptionalquerystringat most 10 charactersNAF activity code (49.41A) or division (49).
departmentoptionalquerystringFrench department code.
includeClosedoptionalquerystringtrue: include closed establishments.
limitoptionalqueryintegerfrom 1 to 100 · default 20

Response 200

OK — A CompanySearch object

Errors

HTTPMeaning
400Invalid request
401Missing, invalid or revoked API key
403Forbidden (scope, plan or account status)
404Resource not found
429Too many requests
500Internal error
Request
curl "https://api.floweet.com/v1/companies?q=transports%20martin" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Response 200
{
  "results": [
    {
      "siret": "84983050000013",
      "siren": "849830500",
      "name": "TS TRANSPORTS",
      "legalName": "TS TRANSPORTS",
      "naf": "49.41A",
      "address": "111 AVENUE ALEXANDER FLEMING",
      "postalCode": "69300",
      "city": "CALUIRE-ET-CUIRE",
      "department": "69",
      "location": {
        "lat": 45.7936248779297,
        "lng": 4.84831619262695
      },
      "headOffice": true,
      "active": true
    },
    {
      "siret": "85183625400017",
      "siren": "851836254",
      "name": "TRANSPORTS TR",
      "legalName": "TRANSPORTS TR",
      "naf": "49.32Z",
      "address": "227 RUE DU GENERAL DE GAULLE",
      "postalCode": "69530",
      "city": "BRIGNAIS",
      "department": "69",
      "location": {
        "lat": 45.6660766601562,
        "lng": 4.75257873535156
      },
      "headOffice": true,
      "active": true
    }
  ]
}

An establishment: legal unit, activity, estimated fleet, franchise network

GET/v1/companies/{siret}Scope companies:read

Parameters

FieldInTypeDescription
siretrequiredpathstring

Response 200

OK — A CompanyDetail object

Errors

HTTPMeaning
400Invalid request
401Missing, invalid or revoked API key
403Forbidden (scope, plan or account status)
404Resource not found
429Too many requests
500Internal error
Request
curl "https://api.floweet.com/v1/companies/84983050000013" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Response 200
{
  "establishment": {
    "siret": "84983050000013",
    "siren": "849830500",
    "name": "TS TRANSPORTS",
    "legalName": "TS TRANSPORTS",
    "naf": "49.41A",
    "address": "111 AVENUE ALEXANDER FLEMING",
    "postalCode": "69300",
    "city": "CALUIRE-ET-CUIRE",
    "department": "69",
    "location": {
      "lat": 45.7936248779297,
      "lng": 4.84831619262695
    },
    "headOffice": true,
    "active": true,
    "headcountBand": "NN",
    "updatedOn": "2025-12-05"
  },
  "nafLabel": "Transports routiers de fret interurbains",
  "legalUnit": null,
  "fleetEstimate": {
    "min": 1,
    "max": 2,
    "mid": 1,
    "vehicleType": "heavy_truck",
    "confidence": "low"
  },
  "franchise": null,
  "siblings": 0
}