# The Data City, contact us, Beta API key, GET /v1/fr/companies/{companyNumber}: Company enrichment API > Returns a single company as host-defined JSON. The Data City's company enrichment API on its Beta API key plan. It returns 6 of the 13 key fields we check: Description, Industry, Type and status, Images, Employees, Headquarters. The cheapest of the 178 plans we rank by price is [treg, top-up from $200](https://datacircle.dev/company-enrichment-apis/treg/top-up-from-200/llms.txt), at $0.496 per 1,000. - This page: https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-fr-companies-companynumber - [Best company enrichment API in 2026](https://datacircle.dev/best-company-enrichment-api.txt) - Get it: https://thedatacity.com/pricing - Its API docs: https://docs.thedatacity.com/global-api/fr/companies/get-a-company - Sold by: The Data City (https://thedatacity.com) - Checked: 2026-10-25 ## In the answer - Completeness: 46% - Description: ✓ - Industry: ✓ - Type and status: ✓ - Images: ✓ - Employees: ✓ - Headquarters: ✓ ## Price - Billing: contact ## Aggregators - Aggregators: none ## In their words - Their pitch: Returns a single company as host-defined JSON. ## Data - Keep data: no API terms - Use data: no API terms ## Rate limit - Per second: 1 - Batch: 1 ## Speed - Answer: in the call ## The call - You send: companyNumber. Optional: includesLocations - Method: GET - Path: /v1/fr/companies/{companyNumber} ## About the plan - Plan: Beta API key - Who can get it: an organisation that emails support@thedatacity.com its name, the email of the person who will hold the key and the markets it expects to use ## The 72 fields the plan's answer can hold website, company description, legal form, employee range, RTICs, logo URL, screenshot URL, operating locations count, SIREN, country, company name, common name, acronym, headquarters address, headquarters postcode, headquarters postcode details, headquarters commune, date of incorporation, NAF section, NAF codes, NAF code, NAF name, operating locations, finances by year, similar companies, RTIC company number, RTIC sector code, RTIC sector name, RTIC vertical code, RTIC vertical name, RTIC score, RTIC words matched, RTIC name, finances by year year ending, finances by year accounts date, finances by year accounts type, finances by year turnover, finances by year EBIT, finances by year net income, finances by year employees here, finances by year employees total, headquarters postcode details code commune INSEE, headquarters postcode details nom commune postal, headquarters postcode details code postal, headquarters postcode details libelle acheminement, headquarters postcode details ligne 5, headquarters postcode details latitude, headquarters postcode details longitude, headquarters postcode details code commune, headquarters postcode details article, headquarters postcode details nom commune, headquarters postcode details nom commune complet, headquarters postcode details code departement, headquarters postcode details nom departement, headquarters postcode details code region, headquarters postcode details nom region, operating location siret, operating location date established, operating location is registered HQ, operating location address, operating location postcode, operating location commune, operating location NAF code, operating location NAF name, operating location employee range, operating location latitude, operating location longitude, operating location postcode details, operating location parent company number, operating location parent company name, similar company company number, similar company similarity score ## The Data City's plans (1) - [The Data City, contact us, Beta API key, GET /v1/fr/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-fr-companies-companynumber/llms.txt): 46% complete ## The Data City's calls (8) - `GET /v1/fr/companies/{companyNumber}`: [The Data City, contact us, Beta API key, GET /v1/fr/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-fr-companies-companynumber/llms.txt) - `GET /v1/de/companies/{companyNumber}`: [The Data City, contact us, Beta API key, GET /v1/de/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-de-companies-companynumber/llms.txt) - `GET /v1/ie/companies/{companyNumber}`: [The Data City, contact us, Beta API key, GET /v1/ie/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-ie-companies-companynumber/llms.txt) - `GET /v1/us/companies/{companyNumber}`: [The Data City, contact us, Beta API key, GET /v1/us/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-us-companies-companynumber/llms.txt) - `POST /v1/fr/companies/batch`: [The Data City, contact us, Beta API key, POST /v1/fr/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-fr-companies-batch/llms.txt) - `POST /v1/de/companies/batch`: [The Data City, contact us, Beta API key, POST /v1/de/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-de-companies-batch/llms.txt) - `POST /v1/ie/companies/batch`: [The Data City, contact us, Beta API key, POST /v1/ie/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-ie-companies-batch/llms.txt) - `POST /v1/us/companies/batch`: [The Data City, contact us, Beta API key, POST /v1/us/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-us-companies-batch/llms.txt) ## The Data City's APIs (6) - [The Data City: similar companies API pricing, 2 plans](https://datacircle.dev/similar-company-apis/the-data-city/free/llms.txt) - [The Data City: company discovery API pricing, 1 plan, POST /v1/fr/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-fr-companies/llms.txt) - [The Data City: company discovery API pricing, 1 plan, POST /v1/de/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-de-companies/llms.txt) - [The Data City: company discovery API pricing, 1 plan, POST /v1/ie/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-ie-companies/llms.txt) - [The Data City: company discovery API pricing, 1 plan, POST /v1/us/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-us-companies/llms.txt) - [The Data City: company discovery API pricing, 1 plan, GET /v1/fr/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-fr-search/llms.txt) - [The Data City: company discovery API pricing, 1 plan, GET /v1/de/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-de-search/llms.txt) - [The Data City: company discovery API pricing, 1 plan, GET /v1/ie/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-ie-search/llms.txt) - [The Data City: company discovery API pricing, 1 plan, GET /v1/us/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-us-search/llms.txt) - [The Data City: company enrichment API pricing, 1 plan, GET /v1/fr/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-fr-companies-companynumber/llms.txt) - [The Data City: company hierarchy API pricing, 2 plans, GET /v1/de/companies/{companyNumber}/group](https://datacircle.dev/company-hierarchy-apis/the-data-city/contact-us-beta-api-key-get-v1-de-companies-companynumber-group/llms.txt) - [The Data City: company hierarchy API pricing, 2 plans, GET /v1/ie/companies/{companyNumber}/group](https://datacircle.dev/company-hierarchy-apis/the-data-city/contact-us-beta-api-key-get-v1-ie-companies-companynumber-group/llms.txt) - [The Data City: company hierarchy API pricing, 2 plans, GET /v1/us/companies/{companyNumber}/group](https://datacircle.dev/company-hierarchy-apis/the-data-city/contact-us-beta-api-key-get-v1-us-companies-companynumber-group/llms.txt) - [The Data City: cached company enrichment API pricing, 1 plan, GET /v2/companies/{companyNumber}](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-get-v2-companies-companynumber/llms.txt) - [The Data City: cached company enrichment API pricing, 1 plan, POST /v2/companies/batch](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-post-v2-companies-batch/llms.txt) - [The Data City: cached company enrichment API pricing, 1 plan, POST /v2/companies/by-website/batch](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-post-v2-companies-by-website-batch/llms.txt) - [The Data City: cached company enrichment API pricing, 1 plan, GET /v2/companies/by-website](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-get-v2-companies-by-website/llms.txt) - [The Data City: cached company enrichment API pricing, 1 plan, POST /v2/companies/by-website](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-post-v2-companies-by-website/llms.txt) - [The Data City: cached company discovery API pricing, 1 plan](https://datacircle.dev/cached-company-discovery-apis/the-data-city/contact-us/llms.txt) ## The Data City: company enrichment API alternatives - [1Lookup, contact us, Custom enterprise, POST /company-firmographics](https://datacircle.dev/company-enrichment-apis/1lookup/contact-us-custom-enterprise-post-company-firmographics/llms.txt): 46% complete - [BetterContact, contact us](https://datacircle.dev/company-enrichment-apis/bettercontact/contact-us/llms.txt): 46% complete - [NeuralVerge, contact us, Custom, POST /functions/v1/run-dealroom-investors](https://datacircle.dev/company-enrichment-apis/neuralverge/contact-us-custom-post-functions-v1-run-dealroom-investors/llms.txt): 46% complete, live - [pipe0, contact us, Larger volumes and enterprise, POST /v1/pipes/run/sync, Company overview (company:overview@3)](https://datacircle.dev/company-enrichment-apis/pipe0/contact-us-larger-volumes-and-enterprise-post-v1-pipes-run-sync-company-overview-company-overview-3/llms.txt): 46% complete - [ReachStream, $39 monthly](https://datacircle.dev/company-enrichment-apis/reachstream/39-monthly/llms.txt): 46% complete ## Sources From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-10-25. - https://docs.thedatacity.com/global-api/fr/companies/get-a-company.md - https://docs.thedatacity.com/global-api/guides/authentication.md - https://docs.thedatacity.com/global-api/guides/rate-limits.md - https://docs.thedatacity.com/global-api/index.md - https://docs.thedatacity.com/instant-classification/guides/rate-limits.md - https://thedatacity.com/api-access - https://thedatacity.com/pricing - https://thedatacity.com/terms-and-conditions