Companies

Returns a paginated list of companies matching your filters.

Pagination & format

Common to all endpoints — see Pagination and Response Modes.

Basic response fields

Filters

Example

curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/companies?states=CA&employee_bands=Mid-market+Accounts&page_size=2"

{
  "ok": true,
  "data": [
    {
      "id": "84629153",
      "company_name": "PACIFIC HEALTH SYSTEMS INC",
      "company_state": "CA",
      "company_city": "SAN FRANCISCO",
      "company_zip": "94105",
      "company_address": "101 CALIFORNIA ST STE 3200",
      "company_dma": "SAN FRANCISCO",
      "company_industry": "Hospitals",
      "employee_band": "Mid-market Accounts",
      "total_number_of_employees": 780,
      "website": "pacifichealthsystems.com",
      "crm_status": ["hubspot"],
      "lead_source": {
        "source": "hillwinds",
        "retrieved_at": "2026-06-24T14:16:00Z"
      }
    }
  ],
  "meta": {
    "total_count": 347,
    "page": 0,
    "page_size": 1,
    "returned": 1,
    "has_more": true,
    "response_tier": "basic",
    "key_tier": "advanced",
    "credits_charged": 0.10
  }
}

Returns a single company by EIN. Returns all fields available to your key's field tier — the OpenAPI spec lists only id as a parameter for this endpoint, so don't expect mode / fields / format to affect the response (the spec is authoritative). For tier control, use GET /v1/companies/lookup?ein=… instead.

curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/companies/84629153"

Exact-match lookup for CRM enrichment. Returns a single company or 404.

Provide exactly one of domain / name / ein. mode, fields, and format are optional and behave the same as on the list endpoint — useful for one-shot CRM enrichment when you want advanced fields in a single call.

curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/companies/lookup?domain=stripe.com"

Look up multiple companies in a single request — the right shape for CRM enrichment and Clay workflows. Provide exactly one of domains or eins(sending both returns 400; sending neither returns 400). Domains use the same normalized exact-domain matcher as the lookup endpoint. Each requested domain returns the same best company as an individual lookup or is named in unmatched; substring/fuzzy website matches are never returned or billed. Max 100 identifiers per request.

curl -X POST -H "Authorization: Bearer ss_live_..." \
  -H "Content-Type: application/json" \
  -d '{"domains": ["stripe.com", "notion.so", "linear.app"]}' \
  "https://api.hillwinds.ai/v1/companies/batch"

Response splits matches from misses:

{
  "ok": true,
  "data": {
    "matched": [
      { "id": "123456789", "company_name": "STRIPE INC", "...": "..." },
      { "id": "987654321", "company_name": "NOTION LABS INC", "...": "..." }
    ],
    "unmatched": ["linear.app"],
    "not_found": ["linear.app"]
  },
  "meta": {
    "total_matched": 2,
    "total_not_found": 1,
    "field_tier": "advanced",
    "credits_charged": 2.00
  }
}

not_found is retained as a compatibility alias of unmatched. Both arrays contain the original input strings rather than normalized replacements.

mode, fields, and format are accepted as query string parameters (not body fields) — same semantics as on the list endpoint. Example: POST /v1/companies/batch?mode=full&format=flat.

Returns a CSV file. Accepts all the same filters as List Companies. Max 2,000 rows per export.

curl -H "Authorization: Bearer ss_live_..." \
  -o companies.csv \
  "https://api.hillwinds.ai/v1/companies/export.csv?states=CA&industries=Hospitals"

Typeahead suggestions. Full cross-resource reference + per-resource matrix on the Autocomplete reference. Companies-specific notes:

• column= allowlist: company_name (default), website. Other values return 400.
• query requires ≥ 2 characters; missing or 1-char → 400. Alias: search (preferred on companies — the query= form sometimes times out under load).
• id is returned as "" today. For name → ID, use GET /v1/companies/lookup?domain=|name=|ein= or the list endpoint with ?search=.
• fields= is accepted but the response shape is fixed to {id, label, resource, value} — useful only if you want to confirm the param is recognized; it doesn't add extra columns.
• Always set limit= — omitting it can produce slow responses.

curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/companies/autocomplete?search=pac&limit=5"

{
  "ok": true,
  "data": [
    {
      "id": "",
      "label": "PACIFIC HEALTH SYSTEMS INC",
      "resource": "companies",
      "value": "PACIFIC HEALTH SYSTEMS INC"
    }
  ],
  "meta": { "credits_charged": 0, "returned": 1 }
}