# The Data City, contact us, Beta API key, POST /v1/us/companies/batch: Company enrichment API > Returns up to 1000 companies by company number as host-defined JSON elements. The Data City's company enrichment API on its Beta API key plan. It returns 8 of the 13 key fields we check: Description, Industry, Type and status, Images, Employees, Headquarters, Revenue and budgets, Phones. 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-post-v1-us-companies-batch - [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/us/companies/get-companies-in-batch - Sold by: The Data City (https://thedatacity.com) - Checked: 2026-10-25 ## In the answer - Completeness: 62% - Description: ✓ - Industry: ✓ - Type and status: ✓ - Images: ✓ - Employees: ✓ - Headquarters: ✓ - Revenue and budgets: ✓ - Phones: ✓ ## Price - Billing: contact ## Aggregators - Aggregators: none ## In their words - Their pitch: Returns up to 1000 companies by company number as host-defined JSON elements. ## Data - Keep data: no API terms - Use data: no API terms ## Rate limit - Per second: 1 - Batch: 1,000 ## Speed - Answer: in the call ## The call - You send: company numbers (a JSON array body) - Method: POST - Path: /v1/us/companies/batch ## 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 65 fields the plan's answer can hold company description, legal form, employee range, RTICs, logo URL, screenshot URL, operating locations count, company number, company name, website, country, address, town, state, phone, reg number, ZIP code, latitude, longitude, companies in group, employees, employees total, turnover, finances by year, best estimate growth percentage per year, directors, activity code, activity code name, SIC code, SIC code name, NAICS code, RNAICS, 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, director first name, director last name, director full name, director local pnr, director date of birth, director date of change, director active, director position, director gender, director language, RNAICS company number, RNAICS code, RNAICS name, RNAICS score, similar company company number, similar company similarity score ## The Data City's plans (1) - [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): 62% 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, 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: 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 - [Waterfall.io, contact us](https://datacircle.dev/company-enrichment-apis/waterfall-io/contact-us/llms.txt): 69% complete - [Context.dev, contact us, Enterprise, POST /v1/brand/retrieve, Lookup by domain](https://datacircle.dev/company-enrichment-apis/context-dev/contact-us-enterprise-post-v1-brand-retrieve-lookup-by-domain/llms.txt): 62% complete, live - [Explorium, contact us, Enterprise, POST /v2/businesses/firmographics/enrich](https://datacircle.dev/company-enrichment-apis/explorium/contact-us-enterprise-post-v2-businesses-firmographics-enrich/llms.txt): 62% complete - [NeuralVerge, contact us, Custom, POST /functions/v1/run-crunchbase-company](https://datacircle.dev/company-enrichment-apis/neuralverge/contact-us-custom-post-functions-v1-run-crunchbase-company/llms.txt): 62% complete, live ## 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/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/global-api/us/companies/get-companies-in-batch.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