Companies

Screen the Hub-Equity universe by criteria

Filters the company universe: 'European tech companies with revenue > 1B audited by Big 4' in one call. All filters are optional ; results carry the matched applied_filters back.

Query params : country (ISO-2), sector (substring), gics_sector, min_revenue / max_revenue (USD, ECB spot rate), min_employees / max_employees, revenue_year, auditor_name (substring), bankruptcy_flag, min_quality_grade (A+/A/B/C/D), sort_by ∈ {revenue_desc, revenue_asc, employees_desc, employees_asc, quality_desc, name_asc}, limit (1-50).

Free plan: limit up to 20 and no min_quality_grade filter (beyond that: 401 AUTH_REQUIRED for an anonymous caller, 403 SCOPE_MISSING for a Free key); any paid plan lifts both. Rate limit: the plan of the calling key (Free 120, Builder 300, Team 600, Enterprise 1,000 per minute).

get/api/v1/companies/screen

Request

  • Base URL: https://api.hub-equity.com
  • URL: https://api.hub-equity.com/api/v1/companies/screen
  • Auth: HTTP bearer

Query parameters

countrystring nullable

ISO-2 country code.

sectorstring nullable

Sector substring match.

gics_sectorstring nullable

Exact GICS sector.

min_revenuenumber nullable

Min revenue (USD, ECB spot rate).

max_revenuenumber nullable

Max revenue (USD, ECB spot rate).

min_employeesinteger nullable
max_employeesinteger nullable
min_quality_gradestring nullable

A+/A/B/C/D minimum grade.

auditor_namestring nullable

Auditor name substring.

bankruptcy_flagboolean nullable
revenue_yearinteger nullable
sort_bystring

revenue_desc | revenue_asc | employees_desc | employees_asc | quality_desc | name_asc.

limitinteger

Max rows (clamped to 50).

Response

Screened companies + applied filters.

successboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.