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.
country?string
Headquarters country code.
industryGroup?string
Company industry group.
employeeCountBucket?string
LinkedIn employee count bucket.
Value in
"1-10" | "11-50" | "51-200" | "201-500" | "501-1000" | "1001-5000" | "5001-10000" | "10001+"foundedYearMin?number
Minimum founded year.
Range
0 <= valuefoundedYearMax?number
Maximum founded year.
Range
0 <= valueResponse 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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" } ], "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "investors": [ { "id": "string", "name": "string" } ], "events": [ { "kind": "funding", "date": "string", "funding": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "round": "series_a", "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", "sources": [ { "url": "https://example.com/acme-ai-series-a", "extractedAt": "2026-05-30T12:00:00.000Z" } ], "confidenceScore": 0.91, "confidence": "high" }, "acquisition": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "sources": [ { "url": "https://example.com/acme-acquires-fooco", "extractedAt": "2026-05-30T12:00:00.000Z" } ], "confidenceScore": 0.88, "confidence": "high" }, "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" }, "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "sources": [ { "url": "https://example.com/acme-names-cfo", "extractedAt": "2026-05-30T12:00:00.000Z" } ], "confidenceScore": 0.84, "confidence": "high" } } ] }, "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": "Company 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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "investors": [ { "id": "string", "name": "string" } ], "events": [ { "kind": "funding", "date": "string", "funding": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "round": "series_a", "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", "sources": [ { "url": "https://example.com/acme-ai-series-a", "extractedAt": "2026-05-30T12:00:00.000Z" } ], "confidenceScore": 0.91, "confidence": "high" }, "acquisition": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "sources": [ { "url": "https://example.com/acme-acquires-fooco", "extractedAt": "2026-05-30T12:00:00.000Z" } ], "confidenceScore": 0.88, "confidence": "high" }, "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" }, "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "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", "sources": [ { "url": "https://example.com/acme-names-cfo", "extractedAt": "2026-05-30T12:00:00.000Z" } ], "confidenceScore": 0.84, "confidence": "high" } } ] } }]{ "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" }}