Skip to main content
GET
/
v1
/
companies
/
export
Export Companies
curl --request GET \
  --url https://api.example.com/v1/companies/export

​
Request

Returns a CSV file of companies (client companies only, not workspace rows) matching the query. Response is streamed with Content-Type: text/csv; charset=utf-8.

​
Query Parameters

​
limit
integer
default:"10000"
Maximum rows per request. Maximum 50,000.
​
industry
string
Filter by industry string.
​
size
string
Filter by size bucket (e.g. 11-50, 51-200).
​
country
string
ISO 3166-1 alpha-2 country code of the HQ location.
​
tag
string
Filter by tag. Repeat to require multiple.
​
fields
string
Comma-separated field whitelist. Defaults to id,name,domain,industry,size,founded_year,hq_location,linkedin_url,tags,created_at.

​
Headers

Authorization: Bearer wbk_your_api_key_here
Accept: text/csv

​
Response

CSV stream with Content-Disposition: attachment; filename="companies-export.csv". First row is headers. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID. 
curl "https://data.leadlex.com/functions/v1/api-gateway/v1/companies/export?industry=Legal%20Services&limit=3000" \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Accept: text/csv" \
  -o companies-legal.csv

​
Example Response

id,name,domain,industry,size,founded_year,hq_location,linkedin_url,tags,created_at
co_01HY1,Acme Corp,acme.com,Legal Services,201-500,1998,"New York, NY, US",https://linkedin.com/company/acme,"priority",2026-02-11T09:00:00Z
co_02HY2,Beta LLP,beta.com,Legal Services,11-50,2014,"Berlin, DE",,"prospect",2026-03-02T10:15:00Z

​
Errors

StatusCodeDescription
400validation_errorlimit exceeds 50,000 or invalid filter value
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing read:companies permission
429rate_limitedExport rate limit exceeded (10 per hour per workspace)