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
Company domain. Matches the primary domain or any domain the company has redirected from; a full URL is accepted and reduced to its domain.
includeTotal?boolean
Also return pagination.total, the number of records matching these filters across all pages. Costs no credits; adds a count query, so ask for it when you need the list size.
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 LinkedIn industry labels listed here, matched case-insensitively; older LinkedIn names (e.g. Computer Software) and common short forms (e.g. software) map to the current label. 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", "website": "https://www.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", "total": 1284 }, "meta": { "endpoint": "funding_events.list", "creditsUsed": 20, "creditsRemaining": 980, "notice": "No events on record for this company." }}{ "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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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" } }, "hiring": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "eventType": "leadership_opening", "function": "sales", "seniority": "vp_level", "roleFamily": "sales_development", "country": { "code": "US", "name": "United States" }, "technologies": [ "salesforce", "gong" ], "announcedAt": "2026-10-02", "endedAt": null, "active": true, "roleCount": 2, "roles": [ { "title": "Head of Sales", "function": "sales", "seniority": "head", "roleFamily": "sales", "location": "London, United Kingdom", "postedAt": "2026-10-02", "url": "https://jobs.ashbyhq.com/acme/1234", "salary": { "min": 185000, "max": 250000, "currency": "USD", "interval": "year" }, "technologies": [ "salesforce", "gong" ] } ], "board": "ashby", "discoveredAt": "2026-10-13T09:20:00.000Z", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "website": "https://www.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, "notice": "No events on record for this company." }}{ "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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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", "website": "https://www.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" } }, "hiring": { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "eventType": "leadership_opening", "function": "sales", "seniority": "vp_level", "roleFamily": "sales_development", "country": { "code": "US", "name": "United States" }, "technologies": [ "salesforce", "gong" ], "announcedAt": "2026-10-02", "endedAt": null, "active": true, "roleCount": 2, "roles": [ { "title": "Head of Sales", "function": "sales", "seniority": "head", "roleFamily": "sales", "location": "London, United Kingdom", "postedAt": "2026-10-02", "url": "https://jobs.ashbyhq.com/acme/1234", "salary": { "min": 185000, "max": 250000, "currency": "USD", "interval": "year" }, "technologies": [ "salesforce", "gong" ] } ], "board": "ashby", "discoveredAt": "2026-10-13T09:20:00.000Z", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "website": "https://www.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" }}Resolve one company by id, domain, name, or LinkedIn URL and return its hiring picture right now: open roles by role family and function, leadership and founding roles, the tools its roles name, its hiring stance and its hiring signals from the last 90 days. Costs one credit. A company we have not read yet answers 202 with meta.discovery and is read straight away; nothing is charged.
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
curl -X GET "https://example.com/v1/companies/hiring"{ "success": true, "data": { "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "website": "https://www.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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "stance": "frozen", "traits": [ "frozen" ], "board": { "platform": "ashby", "careersUrl": "https://jobs.ashbyhq.com/acme", "readAt": "2026-10-14T03:00:00.000Z", "complete": true }, "openRoles": 23, "leadershipRoles": 2, "foundingRoles": 1, "byRoleFamily": [ { "key": "sales_development", "openRoles": 4 } ], "byFunction": [ { "key": "sales_development", "openRoles": 4 } ], "technologies": [ { "technology": "salesforce", "openRoles": 3 } ], "recentSignals": [ { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "eventType": "leadership_opening", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "website": "https://www.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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "function": "sales", "seniority": "vp_level", "roleFamily": "sales_development", "country": { "code": "US", "name": "United States" }, "technologies": [ "salesforce", "gong" ], "announcedAt": "2026-10-02", "endedAt": null, "active": true, "roleCount": 2, "roles": [ { "title": "Head of Sales", "function": "sales", "seniority": "head", "roleFamily": "sales", "location": "London, United Kingdom", "postedAt": "2026-10-02", "url": "https://jobs.ashbyhq.com/acme/1234", "salary": { "min": 185000, "max": 250000, "currency": "USD", "interval": "year" }, "technologies": [ "salesforce", "gong" ] } ], "board": "ashby", "discoveredAt": "2026-10-13T09:20:00.000Z", "confidenceScore": 0.85, "confidence": "high" } ] }, "meta": { "endpoint": "funding_events.list", "creditsUsed": 20, "creditsRemaining": 980, "notice": "No events on record for this company." }}{ "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" }}Profile up to 25 companies. Costs one credit per profile returned, served in order until credits run out; the rest are marked skipped. Companies we have not read yet are marked building and read straight away, and cost nothing. 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 profile, each by id, domain, name, or linkedinUrl. 1 to 25 per request.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/companies/hiring" \ -H "Content-Type: application/json" \ -d '{ "companies": [ {} ] }'[ { "query": { "id": "string", "domain": "legora.com", "name": "Legora", "linkedinUrl": "https://www.linkedin.com/company/wearelegora" }, "status": "served", "profile": { "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "website": "https://www.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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "stance": "frozen", "traits": [ "frozen" ], "board": { "platform": "ashby", "careersUrl": "https://jobs.ashbyhq.com/acme", "readAt": "2026-10-14T03:00:00.000Z", "complete": true }, "openRoles": 23, "leadershipRoles": 2, "foundingRoles": 1, "byRoleFamily": [ { "key": "sales_development", "openRoles": 4 } ], "byFunction": [ { "key": "sales_development", "openRoles": 4 } ], "technologies": [ { "technology": "salesforce", "openRoles": 3 } ], "recentSignals": [ { "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e", "eventType": "leadership_opening", "company": { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "website": "https://www.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", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" }, "function": "sales", "seniority": "vp_level", "roleFamily": "sales_development", "country": { "code": "US", "name": "United States" }, "technologies": [ "salesforce", "gong" ], "announcedAt": "2026-10-02", "endedAt": null, "active": true, "roleCount": 2, "roles": [ { "title": "Head of Sales", "function": "sales", "seniority": "head", "roleFamily": "sales", "location": "London, United Kingdom", "postedAt": "2026-10-02", "url": "https://jobs.ashbyhq.com/acme/1234", "salary": { "min": 185000, "max": 250000, "currency": "USD", "interval": "year" }, "technologies": [ "salesforce", "gong" ] } ], "board": "ashby", "discoveredAt": "2026-10-13T09:20:00.000Z", "confidenceScore": 0.85, "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" }}Hiring Signals
Hiring signals from company job boards: leadership openings, founding roles, team scaling, technology hiring (beta) and hard-to-fill roles, plus each company's current hiring profile. Build-outs, surges, freezes, country expansion and filled leadership roles are rolling out as weekly history accumulates.
Investors
Investor directory records with search, type, country, and domain filters.