API Reference
Companies
Company directory records with search and firmographic filters.
Search and filter company records. Costs one credit per returned record.
Authorization
apiKey X-API-Key<token>
In: header
Query Parameters
cursor?string
Opaque pagination cursor returned as pagination.nextCursor.
since?string
Return companies created or updated on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.
limit?number
Maximum records to return.
Default
20Range
1 <= value <= 100search?string
Keyword search over company name, domain, and description.
domain?string
Exact company domain.
countries?array<>
Headquarters country codes (OR). Repeat the query key for multiple values. Use unknown to match companies with no country on file.
industryGroups?array<>
Company industry groups (OR). Repeat the query key for multiple values. Values are the exact labels listed here — they are matched literally, so pick rather than type. Use unknown to match companies with no industry on file.
naicsCode?string
NAICS 2022 code. Matches the code and everything beneath it, so "51" returns 5132 and 5173 as well. Sector ranges work too: "31-33" returns all manufacturing. Pass "unknown" for companies we could not classify.
Value in
"11" | "111" | "1114" | "113" | "114" | "21" | "2111" | "212" | "22" | "2211" | "2213" | "23" | "236" | "2361" | "238" | "2382" | "31-33" | "311" | "3111" | "3115" | "3116" | "3117" | "3118" | "3121" | "3122" | "313" | "315" | "316" | "3162" | "321" | "322" | "3222" | "323" | "325" | "3253" | "3254" | "3255" | "3256" | "3261" | "327" | "3272" | "331" | "332" | "3323" | "3325" | "3328" | "3331" | "3332" | "3334" | "3341" | "3342" | "3343" | "3344" | "3345" | "335" | "3351" | "3352" | "3353" | "3359" | "336" | "3361" | "3363" | "3364" | "3365" | "3366" | "337" | "3372" | "3391" | "3399" | "42" | "4231" | "4233" | "4234" | "4235" | "4236" | "4238" | "4244" | "4245" | "4246" | "4247" | "4248" | "44-45" | "4411" | "4441" | "4451" | "4491" | "4561" | "4571" | "458" | "4591" | "4593" | "48-49" | "4811" | "482" | "483" | "484" | "485" | "4851" | "4853" | "4921" | "493" | "51" | "5121" | "5122" | "5131" | "5132" | "5161" | "5162" | "5173" | "519" | "5192" | "52" | "5221" | "5231" | "5239" | "5241" | "5242" | "53" | "5311" | "5312" | "532" | "5322" | "54" | "5411" | "5412" | "5413" | "5414" | "5415" | "5416" | "5417" | "5418" | "5419" | "5511" | "56" | "5613" | "5614" | "5615" | "5616" | "5617" | "562" | "5621" | "611" | "6111" | "6113" | "6114" | "6115" | "621" | "6213" | "6214" | "6215" | "6216" | "622" | "623" | "6241" | "6242" | "6244" | "71" | "7111" | "7112" | "7115" | "712" | "7132" | "7139" | "721" | "722" | "7225" | "81" | "811" | "8111" | "812" | "8121" | "8123" | "8129" | "813" | "8131" | "8132" | "8134" | "8139" | "92" | "9211" | "9221" | "9281" | "unknown"employeeCountBuckets?array<>
LinkedIn employee count buckets (OR). Repeat the query key for multiple values. Use unknown to match companies with no headcount on file.
foundedYearMin?number
Minimum founded year.
Range
0 <= valuefoundedYearMax?number
Maximum founded year.
Range
0 <= valuesort?string
Sort order. "prominence" ranks by how notable a company is, from recent funding size and recency, acquisition activity and known people. Default "recent" is the delta-sync order and is what you want when paging the whole corpus.
Value in
"recent" | "prominence"order?string
Direction for the prominence sort. Ignored when sort is "recent", which is always ascending so a delta sync never misses a row.
Value in
"asc" | "desc"minFundingUsdLast12mo?number
Only companies that raised at least this much (USD, not cents) in the last 12 months. Refreshed nightly.
Range
0 <= valueminKnownPeople?number
Only companies with at least this many current known people on record.
Range
0 <= valuehasKnownFounder?boolean
Only companies where a current founder is on record.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/companies"{ "success": true, "data": [ { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" } ], "pagination": { "hasMore": true, "nextCursor": "eyJpZCI6IjAxOWU4YTNjLTJiMTAtN2M0NC04YTFmLTlkOGU3YzZiNWE0MCJ9" }, "meta": { "endpoint": "funding_events.list", "creditsUsed": 20, "creditsRemaining": 980 }}{ "success": false, "error": { "code": "INVALID_INPUT", "message": "limit must not be greater than 100" }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "UNAUTHORIZED", "message": "Missing or invalid API key." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "PAYMENT_REQUIRED", "message": "Workspace has no credits remaining. Top up to continue." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "FORBIDDEN", "message": "Request blocked by abuse prevention policy." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "TOO_MANY_REQUESTS", "message": "Rate limit exceeded for this workspace and plan." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}Resolve one company by id, domain, name, or LinkedIn URL and return its timeline: firmographics, investors, and a chronological list of the event kinds in include (default all). Costs one credit per record returned (the company plus each event). Nothing is charged if no company matches.
Authorization
apiKey X-API-Key<token>
In: header
Query Parameters
id?string
Datahyena company id.
domain?string
Company domain, e.g. legora.com.
name?string
Company name.
linkedinUrl?string
Company LinkedIn URL or handle.
include?array<>
Which event kinds to include. Defaults to all. Each pulled event costs one credit.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/companies/timeline"{ "success": true, "data": { "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" }, "investors": [ { "id": "string", "name": "string" } ], "events": [ { "kind": "funding", "date": "string", "funding": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "round": "series_a", "roundStated": true, "amountUsdCents": 1250000000, "amountUsd": 12500000, "amountOriginalCurrency": "USD", "amountOriginalCents": 1250000000, "investors": [ { "id": "019e8a3c-3c21-7d55-bb2e-0e1f2a3b4c5d", "name": "Example Ventures" } ], "announcedAt": "2026-05-29T00:00:00.000Z", "discoveredAt": "2026-05-30T12:00:00.000Z", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" } }, "acquisition": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "dealAmountUsdCents": 25000000000, "dealAmountUsd": 250000000, "dealAmountOriginalCurrency": "USD", "dealAmountOriginalCents": 25000000000, "paymentType": "cash", "isMerger": false, "announcedAt": "2026-05-29T00:00:00.000Z", "closingAt": "2026-08-01T00:00:00.000Z", "discoveredAt": "2026-05-30T12:00:00.000Z", "acquirer": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" }, "target": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" } }, "execMove": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "person": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Jane Doe", "linkedinHandle": "jane-doe", "linkedinUrl": "https://www.linkedin.com/in/jane-doe" }, "role": "Chief Financial Officer", "roleSeniority": "c_level", "moveType": "appointment", "announcedAt": "2026-05-29T00:00:00.000Z", "effectiveDate": "2026-06-15T00:00:00.000Z", "discoveredAt": "2026-05-30T12:00:00.000Z", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" }, "fromCompany": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" } } } ] }, "meta": { "endpoint": "funding_events.list", "creditsUsed": 20, "creditsRemaining": 980 }}{ "success": false, "error": { "code": "INVALID_INPUT", "message": "limit must not be greater than 100" }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "UNAUTHORIZED", "message": "Missing or invalid API key." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "PAYMENT_REQUIRED", "message": "Workspace has no credits remaining. Top up to continue." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "FORBIDDEN", "message": "Request blocked by abuse prevention policy." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "NOT_FOUND", "message": "Resource not found." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "TOO_MANY_REQUESTS", "message": "Rate limit exceeded for this workspace and plan." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}Resolve up to 25 companies and return each timeline. Costs one credit per record (company plus each included event) per resolved company. Companies are served in order until credits run out; the rest are marked skipped. Unresolved companies cost nothing.
Authorization
apiKey X-API-Key<token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
companies*array<>
Companies to resolve, each by id, domain, name, or linkedinUrl. 1 to 25 per request.
include?array<>
Which event kinds to include. Defaults to all. Each pulled event costs one credit.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/companies/timeline" \ -H "Content-Type: application/json" \ -d '{ "companies": [ {} ] }'[ { "query": {}, "status": "served", "cost": 0, "timeline": { "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" }, "investors": [ { "id": "string", "name": "string" } ], "events": [ { "kind": "funding", "date": "string", "funding": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "round": "series_a", "roundStated": true, "amountUsdCents": 1250000000, "amountUsd": 12500000, "amountOriginalCurrency": "USD", "amountOriginalCents": 1250000000, "investors": [ { "id": "019e8a3c-3c21-7d55-bb2e-0e1f2a3b4c5d", "name": "Example Ventures" } ], "announcedAt": "2026-05-29T00:00:00.000Z", "discoveredAt": "2026-05-30T12:00:00.000Z", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" } }, "acquisition": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "dealAmountUsdCents": 25000000000, "dealAmountUsd": 250000000, "dealAmountOriginalCurrency": "USD", "dealAmountOriginalCents": 25000000000, "paymentType": "cash", "isMerger": false, "announcedAt": "2026-05-29T00:00:00.000Z", "closingAt": "2026-08-01T00:00:00.000Z", "discoveredAt": "2026-05-30T12:00:00.000Z", "acquirer": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" }, "target": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" } }, "execMove": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "person": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Jane Doe", "linkedinHandle": "jane-doe", "linkedinUrl": "https://www.linkedin.com/in/jane-doe" }, "role": "Chief Financial Officer", "roleSeniority": "c_level", "moveType": "appointment", "announcedAt": "2026-05-29T00:00:00.000Z", "effectiveDate": "2026-06-15T00:00:00.000Z", "discoveredAt": "2026-05-30T12:00:00.000Z", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" }, "fromCompany": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "naicsCode": "5132", "naicsLevel": 4, "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "verticals": [ "ai", "fintech" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS" } } } ] } }]{ "success": false, "error": { "code": "INVALID_INPUT", "message": "limit must not be greater than 100" }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "UNAUTHORIZED", "message": "Missing or invalid API key." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "PAYMENT_REQUIRED", "message": "Workspace has no credits remaining. Top up to continue." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "FORBIDDEN", "message": "Request blocked by abuse prevention policy." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "TOO_MANY_REQUESTS", "message": "Rate limit exceeded for this workspace and plan." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}