Getting Started
Hillwinds API
The Hillwinds API gives you programmatic access to benefits intelligence data across 1M+ companies, broker relationships, and 1M+ personnel contacts.
What you can do
- Query companies by size, industry, geography, carriers, brokers, and 20+ filters
- Find decision-maker contacts with email, LinkedIn, title, and seniority data
- Analyze broker relationships, commission data, and carrier networks
- Detect change signals — carrier switches, broker changes, growth events
- Export filtered datasets as CSV for import into CRM or BI tools
- Tag and flag entities for your team's workflow
Endpoint shapes
| Capability | Endpoint shape | Notes |
|---|---|---|
| List with filters + pagination | GET /v1/{resource} | All four Phase-1 entities |
| Get a single entity | GET /v1/{resource}/{id} | — |
| Lookup company (exact, single result) | GET /v1/companies/lookup?domain= / ?name= / ?ein= | Domain normalization, 404 on no match |
| Lookup broker (exact, single result) | GET /v1/brokers/lookup?name= | 404 on no match |
| Bulk lookup / batch enrich | POST /v1/{resource}/batch | Up to 100 IDs (companies), 50 (personnel) |
| Search (fuzzy) | GET /v1/{resource}?search= | Per-entity field list |
| Autocomplete | GET /v1/{resource}/autocomplete | Free (0 credits) |
| Export | GET /v1/{resource}/export.csv | Sync ≤2K rows; async ≤10K (Enterprise only) |
| Dry-run | ?dry_run=true | Returns expected rows + credits, 0 charge |
Base URL
bash
https://api.hillwinds.ai/v1Data coverage
| Entity | Records | Available |
|---|---|---|
| Companies | 1M+ | Now |
| Personnel | 1M+ contacts with email, phone, LinkedIn | Now |
| Broker Offices | 200,000+ | Now |
| Brokers | 200,000+ | Now |
| Carriers | 2,000+ | Phase 2 |
| 401K Providers | 8,000+ | Phase 2 |
| PBM Providers | 4,000+ | Phase 2 |
| Accountants | 4,000+ | Phase 2 |
New to the API?
Start with the Quick Start — you'll have your first response in under two minutes.