{"openapi":"3.0.0","paths":{"/v1/funding-events":{"get":{"description":"Returns funding events ordered by announcement date, newest first. Costs one credit per returned record.","operationId":"funding_events_list","parameters":[{"name":"enrichedOnly","required":false,"in":"query","description":"Return only rounds whose company we resolved — the ones carrying a domain, industry, country and description. Rounds we could not place still ship by default, because for some markets we are the only source that reports them at all; this is how a caller who needs enriched records asks for just those.","schema":{"example":true,"type":"boolean"}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor returned as pagination.nextCursor.","schema":{"type":"string"}},{"name":"since","required":false,"in":"query","description":"Return events announced on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-01","type":"string"}},{"name":"until","required":false,"in":"query","description":"Return events announced on or before this date (YYYY-MM-DD, inclusive). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-30","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum records to return.","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"round","required":false,"in":"query","description":"Funding round filters. Repeat the query key for multiple values.","schema":{"example":["seed","series-a"],"type":"array","items":{"type":"string","enum":["pre-seed","seed","angel","series-a","series-b","series-c","series-d","series-e","series-f","series-g","series-h","series-i","growth","private-equity","extension","bridge","convertible","safe","debt","grant","pre-ipo","secondary","pipe","other"]}}},{"name":"minAmountUsd","required":false,"in":"query","description":"Minimum funding amount in USD.","schema":{"minimum":0,"example":1000000,"type":"number"}},{"name":"maxAmountUsd","required":false,"in":"query","description":"Maximum funding amount in USD.","schema":{"minimum":0,"example":50000000,"type":"number"}},{"name":"naicsCode","required":false,"in":"query","description":"NAICS 2022 code for the company. Matches the code and everything beneath it, so \"51\" also returns 5132 and 5173. Any 2- to 6-digit NAICS code is accepted; codes deeper than we classify (e.g. 541511) match at their deepest classified parent (5415). Sector ranges work: \"31-33\" returns all manufacturing. Pass \"unknown\" for companies we could not classify.","schema":{"example":"5132","type":"string","enum":["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"]}},{"name":"countries","required":false,"in":"query","description":"Headquarters country codes (OR). Repeat the query key for multiple values. Use `unknown` to match companies with no country on file.","schema":{"example":["US","GB"],"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","unknown"]}}},{"name":"industryGroups","required":false,"in":"query","description":"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.","schema":{"example":["Software Development","Financial Services"],"type":"array","items":{"type":"string","enum":["Defense and Space Manufacturing","Computer Hardware Manufacturing","Software Development","Computer Networking Products","Technology, Information and Internet","Semiconductor Manufacturing","Telecommunications","Law Practice","Legal Services","Business Consulting and Services","Biotechnology Research","Medical Practices","Hospitals and Health Care","Pharmaceutical Manufacturing","Veterinary Services","Medical Equipment Manufacturing","Personal Care Product Manufacturing","Retail Apparel and Fashion","Sporting Goods Manufacturing","Tobacco Manufacturing","Retail Groceries","Food and Beverage Manufacturing","Computers and Electronics Manufacturing","Manufacturing","Furniture and Home Furnishings Manufacturing","Retail","Entertainment Providers","Gambling Facilities and Casinos","Travel Arrangements","Hospitality","Restaurants","Spectator Sports","Food and Beverage Services","Movies, Videos and Sound","Broadcast Media Production and Distribution","Museums, Historical Sites, and Zoos","Artists and Writers","Performing Arts","Recreational Facilities","Banking","Insurance","Financial Services","Real Estate","Investment Banking","Investment Management","Accounting","Construction","Wholesale Building Materials","Architecture and Planning","Civil Engineering","Aviation and Aerospace Component Manufacturing","Motor Vehicle Manufacturing","Chemical Manufacturing","Machinery Manufacturing","Mining","Oil and Gas","Shipbuilding","Utilities","Textile Manufacturing","Paper and Forest Product Manufacturing","Railroad Equipment Manufacturing","Farming","Ranching","Dairy Product Manufacturing","Fisheries","Primary and Secondary Education","Higher Education","Education Administration Programs","Research Services","Armed Forces","Legislative Offices","Administration of Justice","International Affairs","Government Administration","Executive Offices","Law Enforcement","Public Safety","Public Policy Offices","Advertising Services","Newspaper Publishing","Book and Periodical Publishing","Printing Services","Information Services","Libraries","Environmental Services","Freight and Package Transportation","Individual and Family Services","Religious Institutions","Civic and Social Organizations","Consumer Services","Truck Transportation","Warehousing and Storage","Airlines and Aviation","Maritime Transportation","IT Services and IT Consulting","Market Research","Public Relations and Communications Services","Design Services","Non-profit Organizations","Fundraising","Strategic Management Services","Writing and Editing","Staffing and Recruiting","Professional Training and Coaching","Venture Capital and Private Equity Principals","Political Organizations","Translation and Localization","Computer Games","Events Services","Retail Art Supplies","Appliances, Electrical, and Electronics Manufacturing","Online Audio and Video Media","Nanotechnology Research","Musicians","Transportation, Logistics, Supply Chain and Storage","Plastics Manufacturing","Computer and Network Security","Wireless Services","Alternative Dispute Resolution","Security and Investigations","Facilities Services","Outsourcing and Offshoring Consulting","Wellness and Fitness Services","Alternative Medicine","Media Production","Animation and Post-production","Leasing Non-residential Real Estate","Capital Markets","Think Tanks","Philanthropic Fundraising Services","E-Learning Providers","Wholesale","Wholesale Import and Export","Industrial Machinery Manufacturing","Photography","Human Resources Services","Retail Office Equipment","Mental Health Care","Graphic Design","International Trade and Development","Beverage Manufacturing","Retail Luxury Goods and Jewelry","Renewable Energy Semiconductor Manufacturing","Glass, Ceramics and Concrete Manufacturing","Packaging and Containers Manufacturing","Automation Machinery Manufacturing","Government Relations Services","Horticulture","Farming, Ranching, Forestry","Ranching and Fisheries","Forestry and Logging","Oil, Gas, and Mining","Coal Mining","Metal Ore Mining","Nonmetallic Mineral Mining","Electric Power Transmission, Control, and Distribution","Electric Power Generation","Hydroelectric Power Generation","Fossil Fuel Electric Power Generation","Nuclear Electric Power Generation","Solar Electric Power Generation","Environmental Quality Programs","Geothermal Electric Power Generation","Biomass Electric Power Generation","Natural Gas Distribution","Water, Waste, Steam, and Air Conditioning Services","Water Supply and Irrigation Systems","Steam and Air-Conditioning Supply","Building Construction","Residential Building Construction","Nonresidential Building Construction","Utility System Construction","Subdivision of Land","Highway, Street, and Bridge Construction","Specialty Trade Contractors","Building Structure and Exterior Contractors","Building Equipment Contractors","Building Finishing Contractors","Animal Feed Manufacturing","Sugar and Confectionery Product Manufacturing","Fruit and Vegetable Preserves Manufacturing","Meat Products Manufacturing","Seafood Product Manufacturing","Baked Goods Manufacturing","Breweries","Distilleries","Apparel Manufacturing","Fashion Accessories Manufacturing","Leather Product Manufacturing","Footwear Manufacturing","Women's Handbag Manufacturing","Oil and Coal Product Manufacturing","Chemical Raw Materials Manufacturing","Artificial Rubber and Synthetic Fiber Manufacturing","Agricultural Chemical Manufacturing","Paint, Coating, and Adhesive Manufacturing","Soap and Cleaning Product Manufacturing","Plastics and Rubber Product Manufacturing","Rubber Products Manufacturing","Clay and Refractory Products Manufacturing","Glass Product Manufacturing","Wood Product Manufacturing","Lime and Gypsum Products Manufacturing","Abrasives and Nonmetallic Minerals Manufacturing","Primary Metal Manufacturing","Fabricated Metal Products","Cutlery and Handtool Manufacturing","Architectural and Structural Metal Manufacturing","Boilers, Tanks, and Shipping Container Manufacturing","Construction Hardware Manufacturing","Spring and Wire Product Manufacturing","Turned Products and Fastener Manufacturing","Metal Treatments","Metal Valve, Ball, and Roller Manufacturing","Agriculture, Construction, Mining Machinery Manufacturing","Commercial and Service Industry Machinery Manufacturing","HVAC and Refrigeration Equipment Manufacturing","Metalworking Machinery Manufacturing","Engines and Power Transmission Equipment Manufacturing","Communications Equipment Manufacturing","Audio and Video Equipment Manufacturing","Measuring and Control Instrument Manufacturing","Magnetic and Optical Media Manufacturing","Electric Lighting Equipment Manufacturing","Household Appliance Manufacturing","Transportation Equipment Manufacturing","Motor Vehicle Parts Manufacturing","Household and Institutional Furniture Manufacturing","Office Furniture and Fixtures Manufacturing","Mattress and Blinds Manufacturing","Wholesale Motor Vehicles and Parts","Wholesale Furniture and Home Furnishings","Wholesale Photography Equipment and Supplies","Wholesale Computer Equipment","Wholesale Metals and Minerals","Wholesale Appliances, Electrical, and Electronics","Wholesale Hardware, Plumbing, Heating Equipment","Wholesale Machinery","Wholesale Recyclable Materials","Wholesale Luxury Goods and Jewelry","Wholesale Paper Products","Wholesale Drugs and Sundries","Wholesale Apparel and Sewing Supplies","Wholesale Footwear","Wholesale Food and Beverage","Wholesale Raw Farm Products","Wholesale Chemical and Allied Products","Wholesale Petroleum and Petroleum Products","Wholesale Alcoholic Beverages","Internet Marketplace Platforms","Retail Motor Vehicles","Retail Furniture and Home Furnishings","Retail Appliances, Electrical, and Electronic Equipment","Retail Building Materials and Garden Equipment","Food and Beverage Retail","Retail Health and Personal Care Products","Retail Gasoline","Retail Musical Instruments","Retail Books and Printed News","Retail Florists","Retail Office Supplies and Gifts","Retail Recyclable Materials & Used Merchandise","Online and Mail Order Retail","Rail Transportation","Ground Passenger Transportation","Urban Transit Services","Interurban and Rural Bus Services","Taxi and Limousine Services","School and Employee Bus Services","Shuttles and Special Needs Transportation Services","Pipeline Transportation","Sightseeing Transportation","Postal Services","Technology, Information and Media","Periodical Publishing","Book Publishing","Movies and Sound Recording","Sound Recording","Sheet Music Publishing","Radio and Television Broadcasting","Cable and Satellite Programming","Telecommunications Carriers","Satellite Telecommunications","Credit Intermediation","Savings Institutions","Loan Brokers","Securities and Commodity Exchanges","Investment Advice","Insurance Carriers","Insurance Agencies and Brokerages","Claims Adjusting, Actuarial Services","Funds and Trusts","Insurance and Employee Benefit Funds","Pension Funds","Trusts and Estates","Real Estate and Equipment Rental Services","Leasing Residential Real Estate","Real Estate Agents and Brokers","Equipment Rental Services","Consumer Goods Rental","Commercial and Industrial Equipment Rental","Professional Services","IT System Design Services","Marketing Services","Holding Companies","Industry Associations","Professional Organizations","Administrative and Support Services","Office Administration","Executive Search Services","Temporary Help Services","Telephone Call Centers","Collection Agencies","Security Guards and Patrol Services","Security Systems Services","Janitorial Services","Waste Collection","Waste Treatment and Disposal","Education","Secretarial Schools","Technical and Vocational Training","Cosmetology and Barber Schools","Flight Training","Fine Arts Schools","Sports and Recreation Instruction","Language Schools","Physicians","Dentists","Chiropractors","Optometrists","Physical, Occupational and Speech Therapists","Family Planning Centers","Outpatient Care Centers","Medical and Diagnostic Laboratories","Home Health Care Services","Ambulance Services","Hospitals","Nursing Homes and Residential Care Facilities","Services for the Elderly and Disabled","Community Services","Emergency and Relief Services","Vocational Rehabilitation Services","Child Day Care Services","Performing Arts and Spectator Sports","Theater Companies","Dance Companies","Circuses and Magic Shows","Sports Teams and Clubs","Racetracks","Museums","Historical Sites","Zoos and Botanical Gardens","Amusement Parks and Arcades","Golf Courses and Country Clubs","Skiing Facilities","Accommodation Services","Hotels and Motels","Bed-and-Breakfasts, Hostels, Homestays","Caterers","Mobile Food Services","Bars, Taverns, and Nightclubs","Repair and Maintenance","Vehicle Repair and Maintenance","Electronic and Precision Equipment Maintenance","Commercial and Industrial Machinery Maintenance","Reupholstery and Furniture Repair","Footwear and Leather Goods Repair","Personal and Laundry Services","Personal Care Services","Laundry and Drycleaning Services","Pet Services","Household Services","Health and Human Services","Public Health","Public Assistance Programs","Air, Water, and Waste Program Management","Conservation Programs","Housing and Community Development","Community Development and Urban Planning","Economic Programs","Military and International Affairs","Operations Consulting","Data Infrastructure and Analytics","Electrical Equipment Manufacturing","Wind Electric Power Generation","Wineries","Landscaping Services","Courts of Law","Correctional Institutions","Fire Protection","Housing Programs","Transportation Programs","Utilities Administration","Space Research and Technology","Oil Extraction","Natural Gas Extraction","Embedded Software Products","Mobile Computing Software Products","Desktop Computing Software Products","IT System Custom Software Development","IT System Operations and Maintenance","IT System Installation and Disposal","IT System Training and Support","IT System Data Services","IT System Testing and Evaluation","Internet News","Blogs","Interior Design","Social Networking Platforms","Business Intelligence Platforms","Business Content","Data Security Software Products","Mobile Gaming Apps","Internet Publishing","Media & Telecommunications","Blockchain Services","Retail Art Dealers","Renewable Energy Power Generation","Renewable Energy Equipment Manufacturing","Engineering Services","Services for Renewable Energy","Digital Accessibility Services","Accessible Hardware Manufacturing","Accessible Architecture and Design","Robot Manufacturing","Robotics Engineering","Surveying and Mapping Services","Retail Pharmacies","Climate Technology Product Manufacturing","Climate Data and Analytics","Alternative Fuel Vehicle Manufacturing","Smart Meter Manufacturing","Fuel Cell Manufacturing","Regenerative Design","unknown"]}}},{"name":"verticals","required":false,"in":"query","description":"Company verticals (OR). High-level sector buckets. Repeat the key for multiple values; free-text like \"artificial intelligence\" is canonicalised. Pass \"unknown\" to include companies we have not tagged with a vertical.","schema":{"example":["ai","fintech"],"type":"array","items":{"type":"string","enum":["ai","fintech","saas","devtools","healthcare","climate","robotics","cybersecurity","logistics","commerce","data","crypto","media","education","marketing","telecom","realestate","hardware","gaming","space","unknown"]}}},{"name":"employeeBuckets","required":false,"in":"query","description":"Company employee-count buckets (OR).","schema":{"example":["11-50","51-200"],"type":"array","items":{"type":"string","enum":["1-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000","10001+"]}}},{"name":"companyId","required":false,"in":"query","description":"Return only events for this entity-resolved company id.","schema":{"example":"019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40","type":"string"}},{"name":"domain","required":false,"in":"query","description":"Return only events for the company at this domain. Matches the company's primary domain or any domain it has redirected from; a full URL is accepted and reduced to its domain. An unknown domain returns an empty page.","schema":{"example":"stripe.com","type":"string"}},{"name":"includeTotal","required":false,"in":"query","description":"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.","schema":{"example":true,"type":"boolean"}}],"responses":{"200":{"description":"Request accepted. The number of records returned may be lower than limit when credits or data run out.","content":{"application/json":{"schema":{"type":"object","required":["success","data","pagination","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicFundingEventResponseItem"}},"pagination":{"$ref":"#/components/schemas/PublicPagination"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"List funding events","tags":["funding-events"]}},"/v1/acquisitions":{"get":{"description":"Returns acquisition and merger events ordered by announcement date, newest first. Costs one credit per returned record.","operationId":"acquisitions_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor returned as pagination.nextCursor.","schema":{"type":"string"}},{"name":"since","required":false,"in":"query","description":"Return events announced on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-01","type":"string"}},{"name":"until","required":false,"in":"query","description":"Return events announced on or before this date (YYYY-MM-DD, inclusive). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-30","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum records to return.","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"paymentType","required":false,"in":"query","description":"Payment type filters. Repeat the query key for multiple values.","schema":{"example":["cash","stock"],"type":"array","items":{"type":"string","enum":["cash","stock","mixed","undisclosed"]}}},{"name":"minAmountUsd","required":false,"in":"query","description":"Minimum deal amount in USD.","schema":{"minimum":0,"example":10000000,"type":"number"}},{"name":"maxAmountUsd","required":false,"in":"query","description":"Maximum deal amount in USD.","schema":{"minimum":0,"example":500000000,"type":"number"}},{"name":"isMerger","required":false,"in":"query","description":"Filter to mergers or non-merger acquisitions.","schema":{"example":false,"type":"boolean"}},{"name":"countries","required":false,"in":"query","description":"Headquarters country codes (OR). Repeat the query key for multiple values. Use `unknown` to match companies with no country on file.","schema":{"example":["US","GB"],"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","unknown"]}}},{"name":"industryGroups","required":false,"in":"query","description":"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.","schema":{"example":["Software Development","Financial Services"],"type":"array","items":{"type":"string","enum":["Defense and Space Manufacturing","Computer Hardware Manufacturing","Software Development","Computer Networking Products","Technology, Information and Internet","Semiconductor Manufacturing","Telecommunications","Law Practice","Legal Services","Business Consulting and Services","Biotechnology Research","Medical Practices","Hospitals and Health Care","Pharmaceutical Manufacturing","Veterinary Services","Medical Equipment Manufacturing","Personal Care Product Manufacturing","Retail Apparel and Fashion","Sporting Goods Manufacturing","Tobacco Manufacturing","Retail Groceries","Food and Beverage Manufacturing","Computers and Electronics Manufacturing","Manufacturing","Furniture and Home Furnishings Manufacturing","Retail","Entertainment Providers","Gambling Facilities and Casinos","Travel Arrangements","Hospitality","Restaurants","Spectator Sports","Food and Beverage Services","Movies, Videos and Sound","Broadcast Media Production and Distribution","Museums, Historical Sites, and Zoos","Artists and Writers","Performing Arts","Recreational Facilities","Banking","Insurance","Financial Services","Real Estate","Investment Banking","Investment Management","Accounting","Construction","Wholesale Building Materials","Architecture and Planning","Civil Engineering","Aviation and Aerospace Component Manufacturing","Motor Vehicle Manufacturing","Chemical Manufacturing","Machinery Manufacturing","Mining","Oil and Gas","Shipbuilding","Utilities","Textile Manufacturing","Paper and Forest Product Manufacturing","Railroad Equipment Manufacturing","Farming","Ranching","Dairy Product Manufacturing","Fisheries","Primary and Secondary Education","Higher Education","Education Administration Programs","Research Services","Armed Forces","Legislative Offices","Administration of Justice","International Affairs","Government Administration","Executive Offices","Law Enforcement","Public Safety","Public Policy Offices","Advertising Services","Newspaper Publishing","Book and Periodical Publishing","Printing Services","Information Services","Libraries","Environmental Services","Freight and Package Transportation","Individual and Family Services","Religious Institutions","Civic and Social Organizations","Consumer Services","Truck Transportation","Warehousing and Storage","Airlines and Aviation","Maritime Transportation","IT Services and IT Consulting","Market Research","Public Relations and Communications Services","Design Services","Non-profit Organizations","Fundraising","Strategic Management Services","Writing and Editing","Staffing and Recruiting","Professional Training and Coaching","Venture Capital and Private Equity Principals","Political Organizations","Translation and Localization","Computer Games","Events Services","Retail Art Supplies","Appliances, Electrical, and Electronics Manufacturing","Online Audio and Video Media","Nanotechnology Research","Musicians","Transportation, Logistics, Supply Chain and Storage","Plastics Manufacturing","Computer and Network Security","Wireless Services","Alternative Dispute Resolution","Security and Investigations","Facilities Services","Outsourcing and Offshoring Consulting","Wellness and Fitness Services","Alternative Medicine","Media Production","Animation and Post-production","Leasing Non-residential Real Estate","Capital Markets","Think Tanks","Philanthropic Fundraising Services","E-Learning Providers","Wholesale","Wholesale Import and Export","Industrial Machinery Manufacturing","Photography","Human Resources Services","Retail Office Equipment","Mental Health Care","Graphic Design","International Trade and Development","Beverage Manufacturing","Retail Luxury Goods and Jewelry","Renewable Energy Semiconductor Manufacturing","Glass, Ceramics and Concrete Manufacturing","Packaging and Containers Manufacturing","Automation Machinery Manufacturing","Government Relations Services","Horticulture","Farming, Ranching, Forestry","Ranching and Fisheries","Forestry and Logging","Oil, Gas, and Mining","Coal Mining","Metal Ore Mining","Nonmetallic Mineral Mining","Electric Power Transmission, Control, and Distribution","Electric Power Generation","Hydroelectric Power Generation","Fossil Fuel Electric Power Generation","Nuclear Electric Power Generation","Solar Electric Power Generation","Environmental Quality Programs","Geothermal Electric Power Generation","Biomass Electric Power Generation","Natural Gas Distribution","Water, Waste, Steam, and Air Conditioning Services","Water Supply and Irrigation Systems","Steam and Air-Conditioning Supply","Building Construction","Residential Building Construction","Nonresidential Building Construction","Utility System Construction","Subdivision of Land","Highway, Street, and Bridge Construction","Specialty Trade Contractors","Building Structure and Exterior Contractors","Building Equipment Contractors","Building Finishing Contractors","Animal Feed Manufacturing","Sugar and Confectionery Product Manufacturing","Fruit and Vegetable Preserves Manufacturing","Meat Products Manufacturing","Seafood Product Manufacturing","Baked Goods Manufacturing","Breweries","Distilleries","Apparel Manufacturing","Fashion Accessories Manufacturing","Leather Product Manufacturing","Footwear Manufacturing","Women's Handbag Manufacturing","Oil and Coal Product Manufacturing","Chemical Raw Materials Manufacturing","Artificial Rubber and Synthetic Fiber Manufacturing","Agricultural Chemical Manufacturing","Paint, Coating, and Adhesive Manufacturing","Soap and Cleaning Product Manufacturing","Plastics and Rubber Product Manufacturing","Rubber Products Manufacturing","Clay and Refractory Products Manufacturing","Glass Product Manufacturing","Wood Product Manufacturing","Lime and Gypsum Products Manufacturing","Abrasives and Nonmetallic Minerals Manufacturing","Primary Metal Manufacturing","Fabricated Metal Products","Cutlery and Handtool Manufacturing","Architectural and Structural Metal Manufacturing","Boilers, Tanks, and Shipping Container Manufacturing","Construction Hardware Manufacturing","Spring and Wire Product Manufacturing","Turned Products and Fastener Manufacturing","Metal Treatments","Metal Valve, Ball, and Roller Manufacturing","Agriculture, Construction, Mining Machinery Manufacturing","Commercial and Service Industry Machinery Manufacturing","HVAC and Refrigeration Equipment Manufacturing","Metalworking Machinery Manufacturing","Engines and Power Transmission Equipment Manufacturing","Communications Equipment Manufacturing","Audio and Video Equipment Manufacturing","Measuring and Control Instrument Manufacturing","Magnetic and Optical Media Manufacturing","Electric Lighting Equipment Manufacturing","Household Appliance Manufacturing","Transportation Equipment Manufacturing","Motor Vehicle Parts Manufacturing","Household and Institutional Furniture Manufacturing","Office Furniture and Fixtures Manufacturing","Mattress and Blinds Manufacturing","Wholesale Motor Vehicles and Parts","Wholesale Furniture and Home Furnishings","Wholesale Photography Equipment and Supplies","Wholesale Computer Equipment","Wholesale Metals and Minerals","Wholesale Appliances, Electrical, and Electronics","Wholesale Hardware, Plumbing, Heating Equipment","Wholesale Machinery","Wholesale Recyclable Materials","Wholesale Luxury Goods and Jewelry","Wholesale Paper Products","Wholesale Drugs and Sundries","Wholesale Apparel and Sewing Supplies","Wholesale Footwear","Wholesale Food and Beverage","Wholesale Raw Farm Products","Wholesale Chemical and Allied Products","Wholesale Petroleum and Petroleum Products","Wholesale Alcoholic Beverages","Internet Marketplace Platforms","Retail Motor Vehicles","Retail Furniture and Home Furnishings","Retail Appliances, Electrical, and Electronic Equipment","Retail Building Materials and Garden Equipment","Food and Beverage Retail","Retail Health and Personal Care Products","Retail Gasoline","Retail Musical Instruments","Retail Books and Printed News","Retail Florists","Retail Office Supplies and Gifts","Retail Recyclable Materials & Used Merchandise","Online and Mail Order Retail","Rail Transportation","Ground Passenger Transportation","Urban Transit Services","Interurban and Rural Bus Services","Taxi and Limousine Services","School and Employee Bus Services","Shuttles and Special Needs Transportation Services","Pipeline Transportation","Sightseeing Transportation","Postal Services","Technology, Information and Media","Periodical Publishing","Book Publishing","Movies and Sound Recording","Sound Recording","Sheet Music Publishing","Radio and Television Broadcasting","Cable and Satellite Programming","Telecommunications Carriers","Satellite Telecommunications","Credit Intermediation","Savings Institutions","Loan Brokers","Securities and Commodity Exchanges","Investment Advice","Insurance Carriers","Insurance Agencies and Brokerages","Claims Adjusting, Actuarial Services","Funds and Trusts","Insurance and Employee Benefit Funds","Pension Funds","Trusts and Estates","Real Estate and Equipment Rental Services","Leasing Residential Real Estate","Real Estate Agents and Brokers","Equipment Rental Services","Consumer Goods Rental","Commercial and Industrial Equipment Rental","Professional Services","IT System Design Services","Marketing Services","Holding Companies","Industry Associations","Professional Organizations","Administrative and Support Services","Office Administration","Executive Search Services","Temporary Help Services","Telephone Call Centers","Collection Agencies","Security Guards and Patrol Services","Security Systems Services","Janitorial Services","Waste Collection","Waste Treatment and Disposal","Education","Secretarial Schools","Technical and Vocational Training","Cosmetology and Barber Schools","Flight Training","Fine Arts Schools","Sports and Recreation Instruction","Language Schools","Physicians","Dentists","Chiropractors","Optometrists","Physical, Occupational and Speech Therapists","Family Planning Centers","Outpatient Care Centers","Medical and Diagnostic Laboratories","Home Health Care Services","Ambulance Services","Hospitals","Nursing Homes and Residential Care Facilities","Services for the Elderly and Disabled","Community Services","Emergency and Relief Services","Vocational Rehabilitation Services","Child Day Care Services","Performing Arts and Spectator Sports","Theater Companies","Dance Companies","Circuses and Magic Shows","Sports Teams and Clubs","Racetracks","Museums","Historical Sites","Zoos and Botanical Gardens","Amusement Parks and Arcades","Golf Courses and Country Clubs","Skiing Facilities","Accommodation Services","Hotels and Motels","Bed-and-Breakfasts, Hostels, Homestays","Caterers","Mobile Food Services","Bars, Taverns, and Nightclubs","Repair and Maintenance","Vehicle Repair and Maintenance","Electronic and Precision Equipment Maintenance","Commercial and Industrial Machinery Maintenance","Reupholstery and Furniture Repair","Footwear and Leather Goods Repair","Personal and Laundry Services","Personal Care Services","Laundry and Drycleaning Services","Pet Services","Household Services","Health and Human Services","Public Health","Public Assistance Programs","Air, Water, and Waste Program Management","Conservation Programs","Housing and Community Development","Community Development and Urban Planning","Economic Programs","Military and International Affairs","Operations Consulting","Data Infrastructure and Analytics","Electrical Equipment Manufacturing","Wind Electric Power Generation","Wineries","Landscaping Services","Courts of Law","Correctional Institutions","Fire Protection","Housing Programs","Transportation Programs","Utilities Administration","Space Research and Technology","Oil Extraction","Natural Gas Extraction","Embedded Software Products","Mobile Computing Software Products","Desktop Computing Software Products","IT System Custom Software Development","IT System Operations and Maintenance","IT System Installation and Disposal","IT System Training and Support","IT System Data Services","IT System Testing and Evaluation","Internet News","Blogs","Interior Design","Social Networking Platforms","Business Intelligence Platforms","Business Content","Data Security Software Products","Mobile Gaming Apps","Internet Publishing","Media & Telecommunications","Blockchain Services","Retail Art Dealers","Renewable Energy Power Generation","Renewable Energy Equipment Manufacturing","Engineering Services","Services for Renewable Energy","Digital Accessibility Services","Accessible Hardware Manufacturing","Accessible Architecture and Design","Robot Manufacturing","Robotics Engineering","Surveying and Mapping Services","Retail Pharmacies","Climate Technology Product Manufacturing","Climate Data and Analytics","Alternative Fuel Vehicle Manufacturing","Smart Meter Manufacturing","Fuel Cell Manufacturing","Regenerative Design","unknown"]}}},{"name":"naicsCode","required":false,"in":"query","description":"NAICS 2022 code for the target (acquired) company. Matches the code and everything beneath it, so \"51\" also returns 5132 and 5173. Any 2- to 6-digit NAICS code is accepted; codes deeper than we classify (e.g. 541511) match at their deepest classified parent (5415). Sector ranges work: \"31-33\" returns all manufacturing. Pass \"unknown\" for companies we could not classify.","schema":{"example":"5132","type":"string","enum":["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"]}},{"name":"verticals","required":false,"in":"query","description":"Target company verticals (OR). High-level sector buckets. Pass \"unknown\" to include companies we have not tagged with a vertical.","schema":{"example":["ai","fintech"],"type":"array","items":{"type":"string","enum":["ai","fintech","saas","devtools","healthcare","climate","robotics","cybersecurity","logistics","commerce","data","crypto","media","education","marketing","telecom","realestate","hardware","gaming","space","unknown"]}}},{"name":"companyId","required":false,"in":"query","description":"Return only events where this company is the acquirer or the target.","schema":{"example":"019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40","type":"string"}},{"name":"domain","required":false,"in":"query","description":"Return only deals where the company at this domain is the acquirer or the target. Matches the primary domain or any domain it has redirected from; a full URL is accepted. An unknown domain returns an empty page.","schema":{"example":"stripe.com","type":"string"}},{"name":"includeTotal","required":false,"in":"query","description":"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.","schema":{"example":true,"type":"boolean"}}],"responses":{"200":{"description":"Request accepted. The number of records returned may be lower than limit when credits or data run out.","content":{"application/json":{"schema":{"type":"object","required":["success","data","pagination","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicAcquisitionEventResponseItem"}},"pagination":{"$ref":"#/components/schemas/PublicPagination"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"List acquisitions","tags":["acquisitions"]}},"/v1/exec-moves":{"get":{"description":"Returns executive appointment, promotion, departure, and transition events ordered by announcement date, newest first. Costs one credit per returned record.","operationId":"exec_moves_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor returned as pagination.nextCursor.","schema":{"type":"string"}},{"name":"companyId","required":false,"in":"query","description":"Company UUID filter.","schema":{"example":"01jykbrpavr3zdvcpzxv","type":"string"}},{"name":"domain","required":false,"in":"query","description":"Return only moves at the company with this domain. Matches the company's primary domain or any domain it has redirected from; a full URL is accepted. An unknown domain returns an empty page.","schema":{"example":"stripe.com","type":"string"}},{"name":"includeTotal","required":false,"in":"query","description":"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.","schema":{"example":true,"type":"boolean"}},{"name":"personId","required":false,"in":"query","description":"Person UUID filter.","schema":{"example":"01jykbrpavr3zdvcpzxw","type":"string"}},{"name":"countries","required":false,"in":"query","description":"Headquarters country codes (OR). Repeat the query key for multiple values.","schema":{"example":["US","GB"],"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","unknown"]}}},{"name":"naicsCode","required":false,"in":"query","description":"NAICS 2022 code for the company. Matches the code and everything beneath it, so \"51\" also returns 5132 and 5173. Any 2- to 6-digit NAICS code is accepted; codes deeper than we classify (e.g. 541511) match at their deepest classified parent (5415). Sector ranges work: \"31-33\" returns all manufacturing. Pass \"unknown\" for companies we could not classify.","schema":{"example":"5132","type":"string","enum":["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"]}},{"name":"roleSeniority","required":false,"in":"query","description":"Role seniority filters. Repeat the query key for multiple values.","schema":{"example":["c_level"],"type":"array","items":{"type":"string","enum":["c_level","vp_level","founder"]}}},{"name":"moveType","required":false,"in":"query","description":"Move type filters. Repeat the query key for multiple values.","schema":{"example":["appointment","promotion"],"type":"array","items":{"type":"string","enum":["appointment","promotion","departure","transition"]}}},{"name":"since","required":false,"in":"query","description":"Return events announced on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-01","type":"string"}},{"name":"until","required":false,"in":"query","description":"Return events announced on or before this date (YYYY-MM-DD, inclusive). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-30","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum records to return.","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":"Request accepted. The number of records returned may be lower than limit when credits or data run out.","content":{"application/json":{"schema":{"type":"object","required":["success","data","pagination","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicExecMoveEventResponseItem"}},"pagination":{"$ref":"#/components/schemas/PublicPagination"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"List executive moves","tags":["exec-moves"]}},"/v1/hiring-signals":{"get":{"description":"Returns hiring signals read from companies' own job boards and careers pages, newest first: leadership openings, founding roles, team scaling, technology hiring (beta) and hard-to-fill roles. Build-outs, surges, freezes, country expansion and filled leadership roles appear as weekly history accumulates. Each signal carries the roles behind it, with salary and technologies where the posting states them. Costs one credit per returned signal.","operationId":"hiring_signals_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor returned as pagination.nextCursor.","schema":{"type":"string"}},{"name":"companyId","required":false,"in":"query","description":"Company UUID filter.","schema":{"example":"01jykbrpavr3zdvcpzxv","type":"string"}},{"name":"domain","required":false,"in":"query","description":"Return only hiring signals for the company with this domain. Matches the company's primary domain or any domain it has redirected from; a full URL is accepted. An unknown domain returns an empty page.","schema":{"example":"figma.com","type":"string"}},{"name":"eventType","required":false,"in":"query","description":"Signal types (OR). Repeat the query key for multiple values.","schema":{"example":["leadership_opening"],"type":"array","items":{"type":"string","enum":["leadership_opening","founding_role","role_family_scaling","technology_hiring","team_buildout","hiring_surge","hiring_freeze","location_expansion","hard_to_fill","leadership_filled"]}}},{"name":"function","required":false,"in":"query","description":"Job functions (OR), for example sales or engineering, or all for company-wide signals.","schema":{"example":["sales","marketing"],"type":"array","items":{"type":"string","enum":["engineering","data","security","it","product","design","sales","marketing","customer_success","operations","finance","people","legal","research","healthcare","executive","other","all"]}}},{"name":"seniority","required":false,"in":"query","description":"Seniority (OR). Matches a leadership opening of that level, or any signal with at least one posting at that level.","schema":{"example":["c_level","vp_level"],"type":"array","items":{"type":"string","enum":["c_level","vp_level","head","director","manager","senior","individual","entry","intern"]}}},{"name":"technologies","required":false,"in":"query","description":"Technologies named in the roles behind the signal (OR), for example snowflake.","schema":{"example":["snowflake","dbt"],"type":"array","items":{"type":"string","enum":["python","typescript","javascript","java","golang","rust","cpp","csharp","ruby","php","kotlin","swift","scala","elixir","sql","react","react-native","nextjs","vue","angular","nodejs","django","fastapi","spring","flutter","graphql","spark","kafka","airflow","dbt","snowflake","databricks","bigquery","redshift","tableau","looker","power-bi","pandas","pytorch","tensorflow","llm","langchain","openai","hugging-face","cuda","aws","gcp","azure","cloudflare","vercel","kubernetes","docker","terraform","ansible","github-actions","datadog","grafana","postgresql","mysql","mongodb","redis","elasticsearch","clickhouse","dynamodb","salesforce","hubspot","zendesk","intercom","outreach","salesloft","gong","apollo","zoominfo","linkedin-sales-navigator","clay","marketo","google-ads","google-analytics","segment","braze","webflow","netsuite","sap","quickbooks","xero","workday","excel","figma","jira","amplitude","mixpanel","notion","soc2","iso27001","okta","crowdstrike"]}}},{"name":"roleFamily","required":false,"in":"query","description":"Role families behind the signal (OR), for example sales_development or revops.","schema":{"example":["sales_development","revops"],"type":"array","items":{"type":"string","enum":["sales_development","sales","sales_engineering","revops","gtm_engineering","partnerships","marketing","demand_gen","product_marketing","content_brand","customer_success","support","software_engineering","hardware_engineering","infrastructure","security","data_engineering","data_analytics","ml_ai","product_management","design","recruiting","people","finance","legal","it","operations","science","production"]}}},{"name":"countries","required":false,"in":"query","description":"Headquarters country codes (OR). Repeat the query key for multiple values.","schema":{"example":["US","GB"],"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","unknown"]}}},{"name":"activeOnly","required":false,"in":"query","description":"Return only signals still in progress: the roles are still open. Ended signals stay available for history.","schema":{"example":true,"type":"boolean"}},{"name":"includeTotal","required":false,"in":"query","description":"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.","schema":{"example":true,"type":"boolean"}},{"name":"since","required":false,"in":"query","description":"Return signals dated on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-10-01","type":"string"}},{"name":"until","required":false,"in":"query","description":"Return signals dated on or before this date (YYYY-MM-DD, inclusive). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-10-31","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum records to return.","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":"Request accepted. The number of records returned may be lower than limit when credits or data run out.","content":{"application/json":{"schema":{"type":"object","required":["success","data","pagination","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicHiringSignalResponseItem"}},"pagination":{"$ref":"#/components/schemas/PublicPagination"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"List hiring signals","tags":["hiring-signals"]}},"/v1/companies":{"get":{"description":"Search and filter company records. Costs one credit per returned record.","operationId":"companies_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor returned as pagination.nextCursor.","schema":{"type":"string"}},{"name":"since","required":false,"in":"query","description":"Return companies created or updated on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-01","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum records to return.","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Keyword search over company name, domain, and description.","schema":{"example":"sales automation","type":"string"}},{"name":"domain","required":false,"in":"query","description":"Company domain. Matches the primary domain or any domain the company has redirected from; a full URL is accepted and reduced to its domain.","schema":{"example":"acme.ai","type":"string"}},{"name":"includeTotal","required":false,"in":"query","description":"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.","schema":{"example":true,"type":"boolean"}},{"name":"countries","required":false,"in":"query","description":"Headquarters country codes (OR). Repeat the query key for multiple values. Use `unknown` to match companies with no country on file.","schema":{"example":["US","GB"],"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","unknown"]}}},{"name":"industryGroups","required":false,"in":"query","description":"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.","schema":{"example":["Software Development","Financial Services"],"type":"array","items":{"type":"string","enum":["Defense and Space Manufacturing","Computer Hardware Manufacturing","Software Development","Computer Networking Products","Technology, Information and Internet","Semiconductor Manufacturing","Telecommunications","Law Practice","Legal Services","Business Consulting and Services","Biotechnology Research","Medical Practices","Hospitals and Health Care","Pharmaceutical Manufacturing","Veterinary Services","Medical Equipment Manufacturing","Personal Care Product Manufacturing","Retail Apparel and Fashion","Sporting Goods Manufacturing","Tobacco Manufacturing","Retail Groceries","Food and Beverage Manufacturing","Computers and Electronics Manufacturing","Manufacturing","Furniture and Home Furnishings Manufacturing","Retail","Entertainment Providers","Gambling Facilities and Casinos","Travel Arrangements","Hospitality","Restaurants","Spectator Sports","Food and Beverage Services","Movies, Videos and Sound","Broadcast Media Production and Distribution","Museums, Historical Sites, and Zoos","Artists and Writers","Performing Arts","Recreational Facilities","Banking","Insurance","Financial Services","Real Estate","Investment Banking","Investment Management","Accounting","Construction","Wholesale Building Materials","Architecture and Planning","Civil Engineering","Aviation and Aerospace Component Manufacturing","Motor Vehicle Manufacturing","Chemical Manufacturing","Machinery Manufacturing","Mining","Oil and Gas","Shipbuilding","Utilities","Textile Manufacturing","Paper and Forest Product Manufacturing","Railroad Equipment Manufacturing","Farming","Ranching","Dairy Product Manufacturing","Fisheries","Primary and Secondary Education","Higher Education","Education Administration Programs","Research Services","Armed Forces","Legislative Offices","Administration of Justice","International Affairs","Government Administration","Executive Offices","Law Enforcement","Public Safety","Public Policy Offices","Advertising Services","Newspaper Publishing","Book and Periodical Publishing","Printing Services","Information Services","Libraries","Environmental Services","Freight and Package Transportation","Individual and Family Services","Religious Institutions","Civic and Social Organizations","Consumer Services","Truck Transportation","Warehousing and Storage","Airlines and Aviation","Maritime Transportation","IT Services and IT Consulting","Market Research","Public Relations and Communications Services","Design Services","Non-profit Organizations","Fundraising","Strategic Management Services","Writing and Editing","Staffing and Recruiting","Professional Training and Coaching","Venture Capital and Private Equity Principals","Political Organizations","Translation and Localization","Computer Games","Events Services","Retail Art Supplies","Appliances, Electrical, and Electronics Manufacturing","Online Audio and Video Media","Nanotechnology Research","Musicians","Transportation, Logistics, Supply Chain and Storage","Plastics Manufacturing","Computer and Network Security","Wireless Services","Alternative Dispute Resolution","Security and Investigations","Facilities Services","Outsourcing and Offshoring Consulting","Wellness and Fitness Services","Alternative Medicine","Media Production","Animation and Post-production","Leasing Non-residential Real Estate","Capital Markets","Think Tanks","Philanthropic Fundraising Services","E-Learning Providers","Wholesale","Wholesale Import and Export","Industrial Machinery Manufacturing","Photography","Human Resources Services","Retail Office Equipment","Mental Health Care","Graphic Design","International Trade and Development","Beverage Manufacturing","Retail Luxury Goods and Jewelry","Renewable Energy Semiconductor Manufacturing","Glass, Ceramics and Concrete Manufacturing","Packaging and Containers Manufacturing","Automation Machinery Manufacturing","Government Relations Services","Horticulture","Farming, Ranching, Forestry","Ranching and Fisheries","Forestry and Logging","Oil, Gas, and Mining","Coal Mining","Metal Ore Mining","Nonmetallic Mineral Mining","Electric Power Transmission, Control, and Distribution","Electric Power Generation","Hydroelectric Power Generation","Fossil Fuel Electric Power Generation","Nuclear Electric Power Generation","Solar Electric Power Generation","Environmental Quality Programs","Geothermal Electric Power Generation","Biomass Electric Power Generation","Natural Gas Distribution","Water, Waste, Steam, and Air Conditioning Services","Water Supply and Irrigation Systems","Steam and Air-Conditioning Supply","Building Construction","Residential Building Construction","Nonresidential Building Construction","Utility System Construction","Subdivision of Land","Highway, Street, and Bridge Construction","Specialty Trade Contractors","Building Structure and Exterior Contractors","Building Equipment Contractors","Building Finishing Contractors","Animal Feed Manufacturing","Sugar and Confectionery Product Manufacturing","Fruit and Vegetable Preserves Manufacturing","Meat Products Manufacturing","Seafood Product Manufacturing","Baked Goods Manufacturing","Breweries","Distilleries","Apparel Manufacturing","Fashion Accessories Manufacturing","Leather Product Manufacturing","Footwear Manufacturing","Women's Handbag Manufacturing","Oil and Coal Product Manufacturing","Chemical Raw Materials Manufacturing","Artificial Rubber and Synthetic Fiber Manufacturing","Agricultural Chemical Manufacturing","Paint, Coating, and Adhesive Manufacturing","Soap and Cleaning Product Manufacturing","Plastics and Rubber Product Manufacturing","Rubber Products Manufacturing","Clay and Refractory Products Manufacturing","Glass Product Manufacturing","Wood Product Manufacturing","Lime and Gypsum Products Manufacturing","Abrasives and Nonmetallic Minerals Manufacturing","Primary Metal Manufacturing","Fabricated Metal Products","Cutlery and Handtool Manufacturing","Architectural and Structural Metal Manufacturing","Boilers, Tanks, and Shipping Container Manufacturing","Construction Hardware Manufacturing","Spring and Wire Product Manufacturing","Turned Products and Fastener Manufacturing","Metal Treatments","Metal Valve, Ball, and Roller Manufacturing","Agriculture, Construction, Mining Machinery Manufacturing","Commercial and Service Industry Machinery Manufacturing","HVAC and Refrigeration Equipment Manufacturing","Metalworking Machinery Manufacturing","Engines and Power Transmission Equipment Manufacturing","Communications Equipment Manufacturing","Audio and Video Equipment Manufacturing","Measuring and Control Instrument Manufacturing","Magnetic and Optical Media Manufacturing","Electric Lighting Equipment Manufacturing","Household Appliance Manufacturing","Transportation Equipment Manufacturing","Motor Vehicle Parts Manufacturing","Household and Institutional Furniture Manufacturing","Office Furniture and Fixtures Manufacturing","Mattress and Blinds Manufacturing","Wholesale Motor Vehicles and Parts","Wholesale Furniture and Home Furnishings","Wholesale Photography Equipment and Supplies","Wholesale Computer Equipment","Wholesale Metals and Minerals","Wholesale Appliances, Electrical, and Electronics","Wholesale Hardware, Plumbing, Heating Equipment","Wholesale Machinery","Wholesale Recyclable Materials","Wholesale Luxury Goods and Jewelry","Wholesale Paper Products","Wholesale Drugs and Sundries","Wholesale Apparel and Sewing Supplies","Wholesale Footwear","Wholesale Food and Beverage","Wholesale Raw Farm Products","Wholesale Chemical and Allied Products","Wholesale Petroleum and Petroleum Products","Wholesale Alcoholic Beverages","Internet Marketplace Platforms","Retail Motor Vehicles","Retail Furniture and Home Furnishings","Retail Appliances, Electrical, and Electronic Equipment","Retail Building Materials and Garden Equipment","Food and Beverage Retail","Retail Health and Personal Care Products","Retail Gasoline","Retail Musical Instruments","Retail Books and Printed News","Retail Florists","Retail Office Supplies and Gifts","Retail Recyclable Materials & Used Merchandise","Online and Mail Order Retail","Rail Transportation","Ground Passenger Transportation","Urban Transit Services","Interurban and Rural Bus Services","Taxi and Limousine Services","School and Employee Bus Services","Shuttles and Special Needs Transportation Services","Pipeline Transportation","Sightseeing Transportation","Postal Services","Technology, Information and Media","Periodical Publishing","Book Publishing","Movies and Sound Recording","Sound Recording","Sheet Music Publishing","Radio and Television Broadcasting","Cable and Satellite Programming","Telecommunications Carriers","Satellite Telecommunications","Credit Intermediation","Savings Institutions","Loan Brokers","Securities and Commodity Exchanges","Investment Advice","Insurance Carriers","Insurance Agencies and Brokerages","Claims Adjusting, Actuarial Services","Funds and Trusts","Insurance and Employee Benefit Funds","Pension Funds","Trusts and Estates","Real Estate and Equipment Rental Services","Leasing Residential Real Estate","Real Estate Agents and Brokers","Equipment Rental Services","Consumer Goods Rental","Commercial and Industrial Equipment Rental","Professional Services","IT System Design Services","Marketing Services","Holding Companies","Industry Associations","Professional Organizations","Administrative and Support Services","Office Administration","Executive Search Services","Temporary Help Services","Telephone Call Centers","Collection Agencies","Security Guards and Patrol Services","Security Systems Services","Janitorial Services","Waste Collection","Waste Treatment and Disposal","Education","Secretarial Schools","Technical and Vocational Training","Cosmetology and Barber Schools","Flight Training","Fine Arts Schools","Sports and Recreation Instruction","Language Schools","Physicians","Dentists","Chiropractors","Optometrists","Physical, Occupational and Speech Therapists","Family Planning Centers","Outpatient Care Centers","Medical and Diagnostic Laboratories","Home Health Care Services","Ambulance Services","Hospitals","Nursing Homes and Residential Care Facilities","Services for the Elderly and Disabled","Community Services","Emergency and Relief Services","Vocational Rehabilitation Services","Child Day Care Services","Performing Arts and Spectator Sports","Theater Companies","Dance Companies","Circuses and Magic Shows","Sports Teams and Clubs","Racetracks","Museums","Historical Sites","Zoos and Botanical Gardens","Amusement Parks and Arcades","Golf Courses and Country Clubs","Skiing Facilities","Accommodation Services","Hotels and Motels","Bed-and-Breakfasts, Hostels, Homestays","Caterers","Mobile Food Services","Bars, Taverns, and Nightclubs","Repair and Maintenance","Vehicle Repair and Maintenance","Electronic and Precision Equipment Maintenance","Commercial and Industrial Machinery Maintenance","Reupholstery and Furniture Repair","Footwear and Leather Goods Repair","Personal and Laundry Services","Personal Care Services","Laundry and Drycleaning Services","Pet Services","Household Services","Health and Human Services","Public Health","Public Assistance Programs","Air, Water, and Waste Program Management","Conservation Programs","Housing and Community Development","Community Development and Urban Planning","Economic Programs","Military and International Affairs","Operations Consulting","Data Infrastructure and Analytics","Electrical Equipment Manufacturing","Wind Electric Power Generation","Wineries","Landscaping Services","Courts of Law","Correctional Institutions","Fire Protection","Housing Programs","Transportation Programs","Utilities Administration","Space Research and Technology","Oil Extraction","Natural Gas Extraction","Embedded Software Products","Mobile Computing Software Products","Desktop Computing Software Products","IT System Custom Software Development","IT System Operations and Maintenance","IT System Installation and Disposal","IT System Training and Support","IT System Data Services","IT System Testing and Evaluation","Internet News","Blogs","Interior Design","Social Networking Platforms","Business Intelligence Platforms","Business Content","Data Security Software Products","Mobile Gaming Apps","Internet Publishing","Media & Telecommunications","Blockchain Services","Retail Art Dealers","Renewable Energy Power Generation","Renewable Energy Equipment Manufacturing","Engineering Services","Services for Renewable Energy","Digital Accessibility Services","Accessible Hardware Manufacturing","Accessible Architecture and Design","Robot Manufacturing","Robotics Engineering","Surveying and Mapping Services","Retail Pharmacies","Climate Technology Product Manufacturing","Climate Data and Analytics","Alternative Fuel Vehicle Manufacturing","Smart Meter Manufacturing","Fuel Cell Manufacturing","Regenerative Design","unknown"]}}},{"name":"naicsCode","required":false,"in":"query","description":"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.","schema":{"example":"5132","type":"string","enum":["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"]}},{"name":"employeeCountBuckets","required":false,"in":"query","description":"LinkedIn employee count buckets (OR). Repeat the query key for multiple values. Use `unknown` to match companies with no headcount on file.","schema":{"example":["11-50","51-200"],"type":"array","items":{"type":"string","enum":["1-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000","10001+","unknown"]}}},{"name":"foundedYearMin","required":false,"in":"query","description":"Minimum founded year.","schema":{"minimum":0,"example":2015,"type":"number"}},{"name":"foundedYearMax","required":false,"in":"query","description":"Maximum founded year.","schema":{"minimum":0,"example":2026,"type":"number"}},{"name":"sort","required":false,"in":"query","description":"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.","schema":{"example":"prominence","type":"string","enum":["recent","prominence"]}},{"name":"order","required":false,"in":"query","description":"Direction for the prominence sort. Ignored when sort is \"recent\", which is always ascending so a delta sync never misses a row.","schema":{"example":"desc","type":"string","enum":["asc","desc"]}},{"name":"minFundingUsdLast12mo","required":false,"in":"query","description":"Only companies that raised at least this much (USD, not cents) in the last 12 months. Refreshed nightly.","schema":{"minimum":0,"example":10000000,"type":"number"}},{"name":"minKnownPeople","required":false,"in":"query","description":"Only companies with at least this many current known people on record.","schema":{"minimum":0,"example":3,"type":"number"}},{"name":"hasKnownFounder","required":false,"in":"query","description":"Only companies where a current founder is on record.","schema":{"example":true,"type":"boolean"}}],"responses":{"200":{"description":"Request accepted. The number of records returned may be lower than limit when credits or data run out.","content":{"application/json":{"schema":{"type":"object","required":["success","data","pagination","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanyDto"}},"pagination":{"$ref":"#/components/schemas/PublicPagination"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"List companies","tags":["companies"]}},"/v1/companies/timeline":{"get":{"description":"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.","operationId":"company_timeline_single","parameters":[{"name":"id","required":false,"in":"query","description":"Datahyena company id.","schema":{"type":"string"}},{"name":"domain","required":false,"in":"query","description":"Company domain, e.g. legora.com.","schema":{"example":"legora.com","type":"string"}},{"name":"name","required":false,"in":"query","description":"Company name.","schema":{"example":"Legora","type":"string"}},{"name":"linkedinUrl","required":false,"in":"query","description":"Company LinkedIn URL or handle.","schema":{"example":"https://www.linkedin.com/company/wearelegora","type":"string"}},{"name":"include","required":false,"in":"query","description":"Which event kinds to include. Defaults to all. Each pulled event costs one credit.","schema":{"type":"array","items":{"type":"string","enum":["funding","acquisitions","exec_moves","hiring"]}}}],"responses":{"200":{"description":"Item resolved. Returns the item and credit usage in meta.","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"$ref":"#/components/schemas/CompanyTimelineDto"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"404":{"description":"No record matched the provided identifier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"NOT_FOUND","message":"Resource not found."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"Company timeline","tags":["companies"]},"post":{"description":"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.","operationId":"company_timeline_bulk","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyTimelineBulkDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompanyTimelineBulkItemDto"}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"Company timelines (bulk)","tags":["companies"]}},"/v1/companies/hiring":{"get":{"description":"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.","operationId":"company_hiring_single","parameters":[{"name":"id","required":false,"in":"query","description":"Datahyena company id.","schema":{"type":"string"}},{"name":"domain","required":false,"in":"query","description":"Company domain, e.g. legora.com.","schema":{"example":"legora.com","type":"string"}},{"name":"name","required":false,"in":"query","description":"Company name.","schema":{"example":"Legora","type":"string"}},{"name":"linkedinUrl","required":false,"in":"query","description":"Company LinkedIn URL or handle.","schema":{"example":"https://www.linkedin.com/company/wearelegora","type":"string"}},{"name":"include","required":false,"in":"query","description":"Which event kinds to include. Defaults to all. Each pulled event costs one credit.","schema":{"type":"array","items":{"type":"string","enum":["funding","acquisitions","exec_moves","hiring"]}}}],"responses":{"200":{"description":"Item resolved. Returns the item and credit usage in meta.","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"$ref":"#/components/schemas/HiringProfileDto"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"Company hiring profile","tags":["companies"]},"post":{"description":"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.","operationId":"company_hiring_bulk","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyHiringBulkDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompanyHiringBulkItemDto"}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"Company hiring profiles (bulk)","tags":["companies"]}},"/v1/investors":{"get":{"description":"Search and filter investor records. Costs one credit per returned record.","operationId":"investors_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor returned as pagination.nextCursor.","schema":{"type":"string"}},{"name":"since","required":false,"in":"query","description":"Return investors created or updated on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.","schema":{"example":"2026-05-01","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum records to return.","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Keyword search over investor name and domain.","schema":{"example":"ventures","type":"string"}},{"name":"type","required":false,"in":"query","description":"Investor type filters. Accepts repeated query keys or comma-separated values.","schema":{"example":["vc","growth"],"type":"array","items":{"type":"string","enum":["vc","angel","cvc","pe","growth","accelerator","family_office","syndicate","unknown"]}}},{"name":"countries","required":false,"in":"query","description":"Headquarters country codes (OR). Repeat the query key for multiple values. Use `unknown` to match companies with no country on file.","schema":{"example":["US","GB"],"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","unknown"]}}},{"name":"domain","required":false,"in":"query","description":"Exact investor domain.","schema":{"example":"example.vc","type":"string"}},{"name":"includeTotal","required":false,"in":"query","description":"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.","schema":{"example":true,"type":"boolean"}},{"name":"hasFirmographics","required":false,"in":"query","description":"Return only investors that have firmographics (a website domain and a known type). Individual angels and firms we could not identify are excluded.","schema":{"example":true,"type":"boolean"}},{"name":"minRoundUsd","required":false,"in":"query","description":"Return only investors that have participated in at least one round at or above this amount, in whole USD. Filters on what an investor has actually done rather than on how it is labelled.","schema":{"minimum":0,"example":20000000,"type":"number"}},{"name":"minRounds","required":false,"in":"query","description":"Return only investors that have participated in at least this many rounds.","schema":{"minimum":1,"example":3,"type":"number"}},{"name":"activeSince","required":false,"in":"query","description":"Return only investors whose most recent round was announced on or after this date (YYYY-MM-DD).","schema":{"example":"2025-08-01","type":"string"}},{"name":"investsIn","required":false,"in":"query","description":"Return only investors that have funded companies headquartered in these countries (OR). Filters on where an investor actually deploys rather than where it is registered, which is both a more useful question and far better covered: 40,692 investors have market data against 2,208 with an HQ country on file.","schema":{"example":["US"],"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW"]}}}],"responses":{"200":{"description":"Request accepted. The number of records returned may be lower than limit when credits or data run out.","content":{"application/json":{"schema":{"type":"object","required":["success","data","pagination","meta"],"properties":{"success":{"type":"boolean","enum":[true],"example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicInvestorResponseItem"}},"pagination":{"$ref":"#/components/schemas/PublicPagination"},"meta":{"$ref":"#/components/schemas/PublicResponseMeta"}}}}}},"400":{"description":"Invalid query parameter, body, or pagination cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"INVALID_INPUT","message":"limit must not be greater than 100"},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"401":{"description":"Missing, invalid, or disabled API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"UNAUTHORIZED","message":"Missing or invalid API key."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"402":{"description":"Workspace has no credits available for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"PAYMENT_REQUIRED","message":"Workspace has no credits remaining. Top up to continue."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"403":{"description":"Request blocked by abuse prevention policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"FORBIDDEN","message":"Request blocked by abuse prevention policy."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}},"429":{"description":"Rate limit exceeded for this workspace and plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"},"example":{"success":false,"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded for this workspace and plan."},"meta":{"requestId":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"}}}}}},"security":[{"apiKey":[]}],"summary":"List investors","tags":["investors"]}}},"info":{"title":"Datahyena Public API","description":"Read-only API for funding events, acquisitions, executive moves, hiring signals, companies, and investors.","version":"1.0","contact":{}},"tags":[{"name":"funding-events","description":"Funding rounds with company, investors, amount, round, and source context.","x-displayName":"Funding Events"},{"name":"acquisitions","description":"Acquisition and merger signals with acquirer, target, amount, and source context.","x-displayName":"Acquisitions"},{"name":"exec-moves","description":"Executive job-change signals across tracked companies and people.","x-displayName":"Executive Moves"},{"name":"hiring-signals","description":"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.","x-displayName":"Hiring Signals"},{"name":"companies","description":"Company directory records with search and firmographic filters.","x-displayName":"Companies"},{"name":"investors","description":"Investor directory records with search, type, country, and domain filters.","x-displayName":"Investors"}],"servers":[{"url":"https://api.datahyena.com","description":"Production"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"UpdateEmailPreferencesViaTokenDto":{"type":"object","properties":{}},"FundingEventInvestorDto":{"type":"object","properties":{"id":{"type":"string","example":"019e8a3c-3c21-7d55-bb2e-0e1f2a3b4c5d"},"name":{"type":"string","example":"Example Ventures"}},"required":["id","name"]},"CountryDto":{"type":"object","properties":{"code":{"type":"string","example":"US","description":"ISO 3166-1 alpha-2 country code."},"name":{"type":"string","example":"United States","description":"Human-readable country name."}},"required":["code","name"]},"PublicCompanyDto":{"type":"object","properties":{"id":{"type":"object","example":"019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40","nullable":true},"name":{"type":"string","example":"Acme AI"},"domain":{"type":"object","example":"acme.ai","nullable":true},"website":{"type":"object","example":"https://www.acme.ai/","nullable":true,"description":"The address the company website loads at, which can differ from domain (for example a www host). Null when no working site is known."},"description":{"type":"object","example":"AI workflow automation for enterprise revenue teams.","nullable":true},"linkedinHandle":{"type":"object","example":"acme-ai","nullable":true},"linkedinUrl":{"type":"object","example":"https://www.linkedin.com/company/acme-ai","nullable":true},"linkedinGeoId":{"type":"object","example":"90000084","nullable":true},"linkedinIndustryId":{"type":"object","example":"4","nullable":true},"naicsCode":{"type":"object","example":"5132","nullable":true,"description":"NAICS 2022 code derived from the industry classification. Null when no honest mapping exists."},"naicsLevel":{"type":"number","example":4,"nullable":true,"enum":[2,3,4],"description":"Depth of naicsCode: 2 = sector, 3 = subsector, 4 = industry group."},"hqCity":{"type":"object","example":"San Francisco","nullable":true},"hqCountry":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/CountryDto"}]},"industryGroup":{"type":"object","example":"Software Development","nullable":true},"industrySubTags":{"example":["Artificial Intelligence","Sales Automation"],"type":"array","items":{"type":"string"}},"verticals":{"example":["ai","fintech"],"type":"array","items":{"type":"string"}},"employeeCountBucket":{"type":"object","example":"51-200","nullable":true},"foundedYear":{"type":"object","example":2021,"nullable":true},"businessModel":{"type":"object","example":"B2B SaaS","nullable":true}},"required":["id","name","domain","website","description","linkedinHandle","linkedinUrl","linkedinGeoId","linkedinIndustryId","naicsCode","naicsLevel","hqCity","hqCountry","industryGroup","industrySubTags","verticals","employeeCountBucket","foundedYear","businessModel"]},"PublicFundingEventResponseItem":{"type":"object","properties":{"id":{"type":"string","example":"019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e"},"round":{"type":"object","example":"series_a","nullable":true},"roundStated":{"type":"object","example":true,"nullable":true,"description":"True when the source stated this round stage explicitly; false when it was inferred; null when no round is recorded."},"amountUsdCents":{"type":"object","example":1250000000,"nullable":true},"amountUsd":{"type":"object","example":12500000,"nullable":true},"amountOriginalCurrency":{"type":"object","example":"USD","nullable":true},"amountOriginalCents":{"type":"object","example":1250000000,"nullable":true},"investors":{"type":"array","items":{"$ref":"#/components/schemas/FundingEventInvestorDto"}},"announcedAt":{"type":"object","example":"2026-05-29T00:00:00.000Z","nullable":true},"discoveredAt":{"type":"string","example":"2026-05-30T12:00:00.000Z"},"company":{"$ref":"#/components/schemas/PublicCompanyDto"}},"required":["id","round","roundStated","amountUsdCents","amountUsd","amountOriginalCurrency","amountOriginalCents","investors","announcedAt","discoveredAt","company"]},"PublicPagination":{"type":"object","properties":{"hasMore":{"type":"boolean","example":true,"description":"Whether another page is available."},"nextCursor":{"type":"object","example":"eyJpZCI6IjAxOWU4YTNjLTJiMTAtN2M0NC04YTFmLTlkOGU3YzZiNWE0MCJ9","nullable":true,"description":"Cursor to pass to the next request. Null when hasMore is false."},"total":{"type":"number","example":1284,"description":"Total records matching the filters across all pages. Present only when includeTotal=true; the same on every page of a listing."}},"required":["hasMore","nextCursor"]},"PublicResponseMeta":{"type":"object","properties":{"endpoint":{"type":"string","example":"funding_events.list","description":"Stable endpoint identifier for logging and support."},"creditsUsed":{"type":"number","example":20,"description":"Credits consumed by this request after the response size is known."},"creditsRemaining":{"type":"object","example":980,"nullable":true,"description":"Workspace credits remaining after this request."},"notice":{"type":"string","example":"No events on record for this company.","description":"Present only when a lookup resolved nothing. Absence of a company is an ordinary outcome here, not a failed request: records are built from funding, acquisition and executive-move announcements, so a company that has not appeared in one is simply not covered."}},"required":["endpoint","creditsUsed","creditsRemaining"]},"PublicErrorBody":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_CURSOR","INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","PAYMENT_REQUIRED","TOO_MANY_REQUESTS"],"example":"INVALID_INPUT"},"message":{"type":"string","example":"limit must not be greater than 100"},"details":{"type":"object","additionalProperties":true,"description":"Optional machine-readable context for validation errors."}},"required":["code","message"]},"PublicErrorMeta":{"type":"object","properties":{"requestId":{"type":"string","example":"019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c","description":"Request id when one was attached by the server."}}},"PublicErrorEnvelope":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"example":false},"error":{"$ref":"#/components/schemas/PublicErrorBody"},"meta":{"$ref":"#/components/schemas/PublicErrorMeta"}},"required":["success","error","meta"]},"PublicAcquisitionEventResponseItem":{"type":"object","properties":{"id":{"type":"string","example":"019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e"},"dealAmountUsdCents":{"type":"object","example":25000000000,"nullable":true},"dealAmountUsd":{"type":"object","example":250000000,"nullable":true},"dealAmountOriginalCurrency":{"type":"object","example":"USD","nullable":true},"dealAmountOriginalCents":{"type":"object","example":25000000000,"nullable":true},"paymentType":{"type":"string","enum":["cash","stock","mixed","undisclosed"],"example":"cash","nullable":true},"isMerger":{"type":"boolean","example":false},"announcedAt":{"type":"object","example":"2026-05-29T00:00:00.000Z","nullable":true},"closingAt":{"type":"object","example":"2026-08-01T00:00:00.000Z","nullable":true},"discoveredAt":{"type":"string","example":"2026-05-30T12:00:00.000Z"},"acquirer":{"$ref":"#/components/schemas/PublicCompanyDto"},"target":{"$ref":"#/components/schemas/PublicCompanyDto"}},"required":["id","dealAmountUsdCents","dealAmountUsd","dealAmountOriginalCurrency","dealAmountOriginalCents","paymentType","isMerger","announcedAt","closingAt","discoveredAt","acquirer","target"]},"ExecMovePersonDto":{"type":"object","properties":{"id":{"type":"object","example":"019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40","nullable":true},"name":{"type":"string","example":"Jane Doe"},"linkedinHandle":{"type":"object","example":"jane-doe","nullable":true},"linkedinUrl":{"type":"object","example":"https://www.linkedin.com/in/jane-doe","nullable":true}},"required":["id","name","linkedinHandle","linkedinUrl"]},"PublicExecMoveEventResponseItem":{"type":"object","properties":{"id":{"type":"string","example":"019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e"},"person":{"$ref":"#/components/schemas/ExecMovePersonDto"},"role":{"type":"string","example":"Chief Financial Officer"},"roleSeniority":{"type":"string","enum":["c_level","vp_level","founder"],"example":"c_level"},"moveType":{"type":"string","enum":["appointment","promotion","departure","transition"],"example":"appointment"},"announcedAt":{"type":"object","example":"2026-05-29T00:00:00.000Z","nullable":true},"effectiveDate":{"type":"object","example":"2026-06-15T00:00:00.000Z","nullable":true},"discoveredAt":{"type":"string","example":"2026-05-30T12:00:00.000Z"},"company":{"$ref":"#/components/schemas/PublicCompanyDto"},"fromCompany":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/PublicCompanyDto"}]}},"required":["id","person","role","roleSeniority","moveType","announcedAt","effectiveDate","discoveredAt","company","fromCompany"]},"HiringSalaryDto":{"type":"object","properties":{"min":{"type":"object","example":185000,"nullable":true},"max":{"type":"object","example":250000,"nullable":true},"currency":{"type":"object","example":"USD","nullable":true},"interval":{"type":"string","example":"year","nullable":true,"enum":["year","month","week","day","hour"]}},"required":["min","max","currency","interval"]},"HiringRoleDto":{"type":"object","properties":{"title":{"type":"string","example":"Head of Sales"},"function":{"type":"string","example":"sales"},"seniority":{"type":"string","example":"head"},"roleFamily":{"type":"object","example":"sales","nullable":true},"location":{"type":"object","example":"London, United Kingdom","nullable":true},"postedAt":{"type":"object","example":"2026-10-02","nullable":true},"url":{"type":"object","example":"https://jobs.ashbyhq.com/acme/1234","nullable":true},"salary":{"nullable":true,"description":"Posted pay range.","type":"object","allOf":[{"$ref":"#/components/schemas/HiringSalaryDto"}]},"technologies":{"example":["salesforce","gong"],"description":"Technologies the role names.","type":"array","items":{"type":"string"}}},"required":["title","function","seniority","roleFamily","location","postedAt","url","salary","technologies"]},"PublicHiringSignalResponseItem":{"type":"object","properties":{"id":{"type":"string","example":"019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e"},"eventType":{"type":"string","example":"leadership_opening"},"function":{"type":"string","example":"sales","description":"The function the signal is about, or all for company-wide signals."},"seniority":{"type":"object","example":"vp_level","nullable":true},"roleFamily":{"type":"object","example":"sales_development","nullable":true,"description":"The role family the signal is about, for example sales_development or revops."},"country":{"nullable":true,"description":"The new country, on location_expansion signals.","type":"object","allOf":[{"$ref":"#/components/schemas/CountryDto"}]},"technologies":{"example":["salesforce","gong"],"description":"Technologies named across the roles behind the signal.","type":"array","items":{"type":"string"}},"announcedAt":{"type":"string","example":"2026-10-02","description":"When the signal started."},"endedAt":{"type":"object","example":null,"nullable":true,"description":"When every role behind it closed."},"active":{"type":"boolean","example":true,"description":"Whether any role behind the signal is still open."},"roleCount":{"type":"number","example":2,"description":"Number of open roles behind the signal."},"roles":{"description":"Up to 10 roles behind the signal.","type":"array","items":{"$ref":"#/components/schemas/HiringRoleDto"}},"board":{"type":"string","example":"ashby","description":"The company's hiring platform."},"discoveredAt":{"type":"string","example":"2026-10-13T09:20:00.000Z"},"company":{"$ref":"#/components/schemas/PublicCompanyDto"}},"required":["id","eventType","function","seniority","roleFamily","country","technologies","announcedAt","endedAt","active","roleCount","roles","board","discoveredAt","company"]},"CompanyTimelineInvestorDto":{"type":"object","properties":{"id":{"type":"string","nullable":true},"name":{"type":"string"}},"required":["id","name"]},"CompanyTimelineEventDto":{"type":"object","properties":{"kind":{"type":"string","enum":["funding","acquisition","exec_move","hiring"]},"date":{"type":"string","nullable":true,"description":"Announcement date (ISO 8601)."},"funding":{"$ref":"#/components/schemas/PublicFundingEventResponseItem"},"acquisition":{"$ref":"#/components/schemas/PublicAcquisitionEventResponseItem"},"execMove":{"$ref":"#/components/schemas/PublicExecMoveEventResponseItem"},"hiring":{"$ref":"#/components/schemas/PublicHiringSignalResponseItem"}},"required":["kind","date"]},"CompanyTimelineDto":{"type":"object","properties":{"company":{"$ref":"#/components/schemas/PublicCompanyDto"},"investors":{"type":"array","items":{"$ref":"#/components/schemas/CompanyTimelineInvestorDto"}},"events":{"description":"Funding rounds, acquisitions, executive moves and hiring signals, most recent first.","type":"array","items":{"$ref":"#/components/schemas/CompanyTimelineEventDto"}}},"required":["company","investors","events"]},"CompanyTimelineSelectorDto":{"type":"object","properties":{"id":{"type":"string","description":"Datahyena company id."},"domain":{"type":"string","example":"legora.com"},"name":{"type":"string","example":"Legora"},"linkedinUrl":{"type":"string","example":"https://www.linkedin.com/company/wearelegora"}}},"CompanyTimelineBulkDto":{"type":"object","properties":{"companies":{"description":"Companies to resolve, each by id, domain, name, or linkedinUrl. 1 to 25 per request.","type":"array","items":{"$ref":"#/components/schemas/CompanyTimelineSelectorDto"}},"include":{"type":"array","description":"Which event kinds to include. Defaults to all. Each pulled event costs one credit.","items":{"type":"string","enum":["funding","acquisitions","exec_moves","hiring"]}}},"required":["companies"]},"CompanyTimelineBulkItemDto":{"type":"object","properties":{"query":{"type":"object","description":"The selector this entry was resolved from."},"status":{"type":"string","enum":["served","skipped_insufficient_credits","not_found"]},"cost":{"type":"number","description":"Credits this timeline costs (company + events). Present when resolved."},"timeline":{"$ref":"#/components/schemas/CompanyTimelineDto"}},"required":["query","status"]},"CompanyDto":{"type":"object","properties":{"id":{"type":"object","example":"019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40","nullable":true},"name":{"type":"string","example":"Acme AI"},"domain":{"type":"object","example":"acme.ai","nullable":true},"website":{"type":"object","example":"https://www.acme.ai/","nullable":true,"description":"The address the company website loads at, which can differ from domain (for example a www host). Null when no working site is known."},"description":{"type":"object","example":"AI workflow automation for enterprise revenue teams.","nullable":true},"linkedinHandle":{"type":"object","example":"acme-ai","nullable":true},"linkedinUrl":{"type":"object","example":"https://www.linkedin.com/company/acme-ai","nullable":true},"linkedinGeoId":{"type":"object","example":"90000084","nullable":true},"linkedinIndustryId":{"type":"object","example":"4","nullable":true},"naicsCode":{"type":"object","example":"5132","nullable":true,"description":"NAICS 2022 code derived from the industry classification. Null when no honest mapping exists."},"naicsLevel":{"type":"number","example":4,"nullable":true,"enum":[2,3,4],"description":"Depth of naicsCode: 2 = sector, 3 = subsector, 4 = industry group."},"hqCity":{"type":"object","example":"San Francisco","nullable":true},"hqCountry":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/CountryDto"}]},"industryGroup":{"type":"object","example":"Software Development","nullable":true},"industrySubTags":{"example":["Artificial Intelligence","Sales Automation"],"type":"array","items":{"type":"string"}},"verticals":{"example":["ai","fintech"],"type":"array","items":{"type":"string"}},"employeeCountBucket":{"type":"object","example":"51-200","nullable":true},"foundedYear":{"type":"object","example":2021,"nullable":true},"businessModel":{"type":"object","example":"B2B SaaS","nullable":true},"createdAt":{"type":"object","example":"2026-05-01T12:00:00.000Z","nullable":true},"updatedAt":{"type":"object","example":"2026-05-30T12:00:00.000Z","nullable":true}},"required":["id","name","domain","website","description","linkedinHandle","linkedinUrl","linkedinGeoId","linkedinIndustryId","naicsCode","naicsLevel","hqCity","hqCountry","industryGroup","industrySubTags","verticals","employeeCountBucket","foundedYear","businessModel","createdAt","updatedAt"]},"HiringBoardDto":{"type":"object","properties":{"platform":{"type":"string","example":"ashby","description":"The company's hiring platform, or careers_page."},"careersUrl":{"type":"object","example":"https://jobs.ashbyhq.com/acme","nullable":true},"readAt":{"type":"string","example":"2026-10-14T03:00:00.000Z","description":"When we last read it."},"complete":{"type":"object","example":true,"nullable":true,"description":"Whether the last read listed every open role the board reports."}},"required":["platform","careersUrl","readAt","complete"]},"HiringBreakdownDto":{"type":"object","properties":{"key":{"type":"string","example":"sales_development"},"openRoles":{"type":"number","example":4}},"required":["key","openRoles"]},"HiringTechnologyCountDto":{"type":"object","properties":{"technology":{"type":"string","example":"salesforce"},"openRoles":{"type":"number","example":3}},"required":["technology","openRoles"]},"HiringSignalResponseItem":{"type":"object","properties":{"id":{"type":"string","example":"019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e"},"eventType":{"type":"string","example":"leadership_opening"},"company":{"$ref":"#/components/schemas/CompanyDto"},"function":{"type":"string","example":"sales","description":"The function the signal is about, or all for company-wide signals."},"seniority":{"type":"object","example":"vp_level","nullable":true},"roleFamily":{"type":"object","example":"sales_development","nullable":true,"description":"The role family the signal is about, for example sales_development or revops."},"country":{"nullable":true,"description":"The new country, on location_expansion signals.","type":"object","allOf":[{"$ref":"#/components/schemas/CountryDto"}]},"technologies":{"example":["salesforce","gong"],"description":"Technologies named across the roles behind the signal.","type":"array","items":{"type":"string"}},"announcedAt":{"type":"string","example":"2026-10-02","description":"When the signal started."},"endedAt":{"type":"object","example":null,"nullable":true,"description":"When every role behind it closed."},"active":{"type":"boolean","example":true,"description":"Whether any role behind the signal is still open."},"roleCount":{"type":"number","example":2,"description":"Number of open roles behind the signal."},"roles":{"description":"Up to 10 roles behind the signal.","type":"array","items":{"$ref":"#/components/schemas/HiringRoleDto"}},"board":{"type":"string","example":"ashby","description":"The company's hiring platform."},"discoveredAt":{"type":"string","example":"2026-10-13T09:20:00.000Z"},"confidenceScore":{"type":"object","example":0.85,"nullable":true,"minimum":0,"maximum":1},"confidence":{"type":"string","enum":["high","medium","low"],"example":"high","nullable":true}},"required":["id","eventType","company","function","seniority","roleFamily","country","technologies","announcedAt","endedAt","active","roleCount","roles","board","discoveredAt","confidenceScore","confidence"]},"HiringProfileDto":{"type":"object","properties":{"company":{"$ref":"#/components/schemas/CompanyDto"},"stance":{"type":"string","enum":["frozen","none_open","expanding","building_founding_team","building_leadership","building_gtm","scaling_engineering","hiring_steadily","no_public_board"],"description":"The company hiring stance right now. no_public_board means we found no public job board, which is not the same as not hiring."},"traits":{"type":"array","description":"Every stance that applies, most significant first.","items":{"type":"string","enum":["frozen","none_open","expanding","building_founding_team","building_leadership","building_gtm","scaling_engineering","hiring_steadily","no_public_board"]}},"board":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/HiringBoardDto"}]},"openRoles":{"type":"number","example":23,"description":"Open roles the board reports."},"leadershipRoles":{"type":"number","example":2,"description":"Open leadership roles (C-level, VP, Head, Director)."},"foundingRoles":{"type":"number","example":1,"description":"Open founding or first-hire roles."},"byRoleFamily":{"description":"Open roles by role family.","type":"array","items":{"$ref":"#/components/schemas/HiringBreakdownDto"}},"byFunction":{"description":"Open roles by function.","type":"array","items":{"$ref":"#/components/schemas/HiringBreakdownDto"}},"technologies":{"description":"Business tools the open roles name, most frequent first.","type":"array","items":{"$ref":"#/components/schemas/HiringTechnologyCountDto"}},"recentSignals":{"description":"Hiring signals from the last 90 days, newest first, up to 10.","type":"array","items":{"$ref":"#/components/schemas/HiringSignalResponseItem"}}},"required":["company","stance","traits","board","openRoles","leadershipRoles","foundingRoles","byRoleFamily","byFunction","technologies","recentSignals"]},"CompanyHiringBulkDto":{"type":"object","properties":{"companies":{"description":"Companies to profile, each by id, domain, name, or linkedinUrl. 1 to 25 per request.","type":"array","items":{"$ref":"#/components/schemas/CompanyTimelineSelectorDto"}}},"required":["companies"]},"CompanyHiringBulkItemDto":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/CompanyTimelineSelectorDto"},"status":{"type":"string","enum":["served","building","not_found","skipped_insufficient_credits"],"description":"building means we had not read this company and have started now; ask again in a few minutes."},"profile":{"$ref":"#/components/schemas/HiringProfileDto"}},"required":["query","status"]},"PublicInvestorResponseItem":{"type":"object","properties":{"id":{"type":"string","example":"019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40"},"name":{"type":"string","example":"Example Ventures"},"type":{"type":"string","enum":["vc","angel","cvc","pe","growth","accelerator","family_office","syndicate","unknown"],"example":"vc"},"hqCountry":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/CountryDto"}]},"domain":{"type":"object","example":"example.vc","nullable":true},"roundsCount":{"type":"number","example":42,"description":"Funding rounds this investor has participated in."},"largestRoundUsd":{"type":"object","example":120000000,"nullable":true,"description":"Largest round this investor has participated in, in whole USD."},"firstRoundAt":{"type":"object","example":"2021-03-04T00:00:00.000Z","nullable":true},"lastRoundAt":{"type":"object","example":"2026-08-14T00:00:00.000Z","nullable":true},"activeMarkets":{"description":"Countries this investor has funded companies in, most-backed first.","type":"array","items":{"$ref":"#/components/schemas/CountryDto"}}},"required":["id","name","type","hqCountry","domain","roundsCount","largestRoundUsd","firstRoundAt","lastRoundAt","activeMarkets"]},"BatchResolveBodyDto":{"type":"object","properties":{}},"IngestCompanyBodyDto":{"type":"object","properties":{}},"IngestBatchBodyDto":{"type":"object","properties":{}},"CreateApiKeyDto":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable label","example":"Production"},"expiresAt":{"type":"string","description":"When the key stops working (ISO 8601). Omit for a key that never expires.","example":"2026-12-31T23:59:59Z"},"allowedIps":{"description":"IP addresses or CIDR ranges allowed to use the key, up to 20. Omit to allow any IP.","example":["203.0.113.7","10.0.0.0/8"],"type":"array","items":{"type":"string"}}},"required":["name"]},"UpdateApiKeyDto":{"type":"object","properties":{"expiresAt":{"type":"object","description":"When the key stops working (ISO 8601), or null to remove the expiry.","nullable":true,"example":"2026-12-31T23:59:59Z"},"allowedIps":{"type":"object","description":"IP addresses or CIDR ranges allowed to use the key, up to 20, or null to allow any IP.","nullable":true,"example":["203.0.113.7"]}}},"CreateWorkspaceDto":{"type":"object","properties":{"name":{"type":"string","description":"Workspace display name","example":"Acme Inc"}},"required":["name"]},"UpdateWorkspaceDto":{"type":"object","properties":{"name":{"type":"string","description":"Workspace display name"}}},"UpdateMemberRoleDto":{"type":"object","properties":{"role":{"type":"string","enum":["owner","admin","member"]}},"required":["role"]},"CreateInvitationDto":{"type":"object","properties":{"email":{"type":"string","description":"Invitee email","example":"colleague@example.com"},"role":{"type":"string","enum":["owner","admin","member"],"description":"Role to assign on accept"}},"required":["email","role"]},"AcceptInvitationDto":{"type":"object","properties":{}},"CreateJoinRequestDto":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace to request access to"}},"required":["workspaceId"]},"UpdateProfileDto":{"type":"object","properties":{}},"UpdateOnboardingDto":{"type":"object","properties":{}},"UpdatePasswordDto":{"type":"object","properties":{}},"RegisterDto":{"type":"object","properties":{"email":{"type":"string","description":"Email address","example":"user@example.com"},"password":{"type":"string","description":"Password (min 8 chars)","example":"SecurePass123!"},"name":{"type":"string","description":"Full name","example":"Jane Doe"},"invitationToken":{"type":"string","description":"Invitation token, when signing up from a workspace invite. Skips email verification if it matches this address."},"turnstileToken":{"type":"string","description":"Cloudflare Turnstile token"}},"required":["email","password","name"]},"LoginDto":{"type":"object","properties":{"email":{"type":"string","description":"Email address","example":"user@example.com"},"password":{"type":"string","description":"Password","example":"password"},"turnstileToken":{"type":"string","description":"Cloudflare Turnstile token"}},"required":["email","password"]},"Verify2faDto":{"type":"object","properties":{"tempToken":{"type":"string","description":"Temp token issued after password verification","example":"eyJ..."},"token":{"type":"string","description":"6-digit TOTP code","example":"123456"},"backupCode":{"type":"string","description":"8-char backup code"}},"required":["tempToken"]},"ForgotPasswordDto":{"type":"object","properties":{"email":{"type":"string","description":"Email address","example":"user@example.com"}},"required":["email"]},"ResetPasswordDto":{"type":"object","properties":{"password":{"type":"string","description":"New password","example":"SecurePass123!"},"token":{"type":"string","description":"Reset token from email","example":"eyJ..."}},"required":["password","token"]},"ResetPasswordCodeDto":{"type":"object","properties":{"email":{"type":"string","description":"The email address the reset code was sent to","example":"user@example.com"},"code":{"type":"string","description":"The six digit code from the reset email","example":"123456"},"password":{"type":"string","description":"The new password","example":"a-strong-password"}},"required":["email","code","password"]},"VerifyEmailCodeDto":{"type":"object","properties":{"code":{"type":"string","description":"The six digit code from the verification email","example":"123456"}},"required":["code"]},"VerifyTotpSetupDto":{"type":"object","properties":{}},"VerifyTotpDto":{"type":"object","properties":{}},"RegenerateBackupCodesDto":{"type":"object","properties":{}},"WatchlistNameDto":{"type":"object","properties":{"name":{"type":"string","example":"Q3 target accounts"}},"required":["name"]},"WatchlistDto":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"memberCount":{"type":"number","description":"Number of resolved companies on the list."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","memberCount","createdAt","updatedAt"]},"WatchlistMemberDto":{"type":"object","properties":{"companyId":{"type":"string"},"name":{"type":"string","nullable":true},"domain":{"type":"string","nullable":true},"sourceIdentifier":{"type":"string","description":"The identifier the caller submitted for this company."},"addedAt":{"type":"string"}},"required":["companyId","name","domain","sourceIdentifier","addedAt"]},"WatchlistWithMembersDto":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"memberCount":{"type":"number","description":"Number of resolved companies on the list."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"members":{"type":"array","items":{"$ref":"#/components/schemas/WatchlistMemberDto"}}},"required":["id","name","memberCount","createdAt","updatedAt","members"]},"WatchlistCompaniesDto":{"type":"object","properties":{"companies":{"example":["stripe.com","Anthropic","https://www.linkedin.com/company/openai"],"description":"Company identifiers, one per entry: a domain, company name, LinkedIn URL, or Datahyena company id.","type":"array","items":{"type":"string"}}},"required":["companies"]},"WatchlistAddItemDto":{"type":"object","properties":{"input":{"type":"string","description":"The identifier the caller submitted."},"status":{"type":"string","enum":["added","already_present","unresolved"]},"companyId":{"type":"string","nullable":true}},"required":["input","status"]},"WatchlistAddResultDto":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/WatchlistAddItemDto"}},"added":{"type":"number"},"alreadyPresent":{"type":"number"},"unresolved":{"type":"number"}},"required":["results","added","alreadyPresent","unresolved"]},"WatchlistRemoveResultDto":{"type":"object","properties":{"removed":{"type":"number"}},"required":["removed"]},"HarnessApplyDto":{"type":"object","properties":{}},"HarnessCloseDto":{"type":"object","properties":{}},"HarnessIngestDto":{"type":"object","properties":{}},"HarnessReportDto":{"type":"object","properties":{}},"HarnessSnoozeDto":{"type":"object","properties":{}},"HarnessAuditVerdictDto":{"type":"object","properties":{}},"HarnessRevertDto":{"type":"object","properties":{}},"DecideSourceHostDto":{"type":"object","properties":{}},"ToggleSourceDto":{"type":"object","properties":{}},"ReenqueueExtractionsDto":{"type":"object","properties":{}},"RestoreArticleLinksDto":{"type":"object","properties":{}},"RejudgeUndecidedDto":{"type":"object","properties":{}},"IngestUrlsDto":{"type":"object","properties":{}},"RederiveRecordsDto":{"type":"object","properties":{}},"ReenrichCompanyDto":{"type":"object","properties":{}},"AgentRederiveDto":{"type":"object","properties":{}},"AgentRequeueDto":{"type":"object","properties":{}},"AgentCancelWorkDto":{"type":"object","properties":{}},"AgentRestoreLinksDto":{"type":"object","properties":{}},"AgentRunChecksDto":{"type":"object","properties":{}},"AgentMergeCompaniesDto":{"type":"object","properties":{}},"AgentReleaseClaimsDto":{"type":"object","properties":{}},"AgentRetractDto":{"type":"object","properties":{}},"AgentFollowCitationsDto":{"type":"object","properties":{}},"AgentReextractDto":{"type":"object","properties":{}},"RunScheduledWorkDto":{"type":"object","properties":{}},"CloseIssueDto":{"type":"object","properties":{}},"SnoozeIssueDto":{"type":"object","properties":{}},"SetAutofixDto":{"type":"object","properties":{}},"ApplyCorrectionsDto":{"type":"object","properties":{}},"CreateContractDto":{"type":"object","properties":{}},"UpdateContractDto":{"type":"object","properties":{}},"CreateDeliveryConfigDto":{"type":"object","properties":{}},"UpdateDeliveryConfigDto":{"type":"object","properties":{}},"SamplePushDto":{"type":"object","properties":{}},"SampleDownloadDto":{"type":"object","properties":{}},"TestDestinationDto":{"type":"object","properties":{}},"IngestUrlDto":{"type":"object","properties":{"url":{"type":"string","description":"Article URL to ingest. Attached to the source that owns the host, or to manual-ingest.","example":"https://www.cnbc.com/2026/03/31/airtel-nxtra-1-billion-carlyle.html"}},"required":["url"]},"StartFeedbackThreadDto":{"type":"object","properties":{"userId":{"type":"string","description":"User the conversation is addressed to"},"subject":{"type":"string","description":"Thread subject"},"message":{"type":"string","description":"Opening message"}},"required":["userId","subject","message"]},"CreateFeedbackMessageDto":{"type":"object","properties":{"message":{"type":"string","description":"Reply text"}},"required":["message"]},"UpdateFeedbackStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["new","reviewing","resolved","archived"]}},"required":["status"]},"PreviewLeadsDto":{"type":"object","properties":{"email":{"type":"string","example":"jane@acme.com","description":"Work email to unlock the preview."},"signalType":{"type":"string","enum":["funding","acquisition","exec_move"],"example":"funding"},"industryGroups":{"example":["Software Development"],"type":"array","items":{"type":"string"}},"countries":{"example":["US","GB"],"type":"array","items":{"type":"string"}},"rounds":{"example":["seed","series-a"],"type":"array","items":{"type":"string"}},"employeeBuckets":{"example":["11-50","51-200"],"type":"array","items":{"type":"string"}},"source":{"type":"string","example":"reddit","description":"Channel attribution (utm_source)."},"turnstileToken":{"type":"string","description":"Cloudflare Turnstile token."}},"required":["email","signalType"]},"OpenBoardDto":{"type":"object","properties":{"email":{"type":"string","example":"jane@acme.com","description":"Work email matching the board domain."},"source":{"type":"string","example":"reddit","description":"Channel attribution (utm_source)."},"turnstileToken":{"type":"string","description":"Cloudflare Turnstile token."}},"required":["email"]},"CreateFeedbackDto":{"type":"object","properties":{"category":{"type":"string","enum":["issue","feature","question","other"],"description":"Feedback category"},"description":{"type":"string","description":"Feedback message body"}},"required":["category","description"]},"CreateKelviqCheckoutDto":{"type":"object","properties":{"planIdentifier":{"type":"string","description":"Kelviq plan or pack identifier (e.g. \"growth\", \"payg\")"},"successUrl":{"type":"string","description":"URL Kelviq redirects to after successful checkout"},"chargePeriod":{"type":"string","description":"Charge period. MONTHLY for subscription plans, ONE_TIME for credit packs.","enum":["MONTHLY","ONE_TIME"],"default":"MONTHLY"}},"required":["planIdentifier","successUrl"]},"ChangePlanDto":{"type":"object","properties":{"planSlug":{"type":"string","description":"Target subscription plan slug","enum":["starter","growth","scale"]},"endTrialNow":{"type":"boolean","description":"End the trial immediately and activate the paid plan now. Ignored unless the subscription is currently on trial.","default":false}},"required":["planSlug"]},"CreateWebhookEndpointDto":{"type":"object","properties":{"url":{"type":"string","example":"https://example.com/hooks/datahyena"},"events":{"type":"array","items":{"type":"string","enum":["funding.created","acquisition.created","exec_move.created","hiring.created"]}},"description":{"type":"string","example":"Production funding feed"},"filters":{"type":"object","description":"Per-event-kind delivery filters"},"watchlistId":{"type":"string","description":"Bind the endpoint to a watchlist so it only fires for events whose company is on that list."}},"required":["url","events"]},"UpdateWebhookEndpointDto":{"type":"object","properties":{"url":{"type":"string","example":"https://example.com/hooks/datahyena"},"events":{"type":"array","items":{"type":"string","enum":["funding.created","acquisition.created","exec_move.created","hiring.created"]}},"description":{"type":"string"},"filters":{"type":"object"},"isActive":{"type":"boolean"},"watchlistId":{"type":"object","nullable":true,"description":"Bind the endpoint to a watchlist, or null to unbind it."}}},"ReplayWebhookDto":{"type":"object","properties":{"since":{"type":"string","description":"Only replay events recorded on or after this date. Omit to replay from the start.","example":"2026-01-01"},"resendDelivered":{"type":"boolean","description":"Resend events this endpoint already received. Defaults to false (skip them)."}}}}},"security":[{"apiKey":[]}]}