List companies
Authorizations
Query Parameters
Page number, 1-indexed. Clamped to >= 1.
Results per page. Clamped to the range 1-100 (values outside are silently capped, not rejected).
Case-insensitive substring match on company name.
Exact match on the company's LinkedIn URL.
Website domain to match (e.g. 'acme.com'), same semantics as the domain parameter on GET /v1/companies/lookup.
Return only companies modified at or after this ISO 8601 timestamp (e.g. '2025-01-01T00:00:00Z'). Filtered on the rings_updated_at field which tracks the last time Rings updated the record.
Field to sort by. Valid values: 'name', 'last_activity_date'
name, last_activity_date Sort order. Valid values: 'asc' (ascending) or 'desc' (descending)
asc, desc Case-insensitive substring match on description.
Case-insensitive substring match on facebook_url.
Case-insensitive substring match on twitter_url.
Case-insensitive substring match on city.
State/region name; resolved via pycountry and matched exactly against the stored canonical name (scoped to country when provided).
Country name or code; resolved via pycountry and matched exactly against the stored canonical name.
Comma-separated operating statuses (OR-matched).
Comma-separated acquisition statuses (OR-matched).
Comma-separated IPO statuses (OR-matched).
Comma-separated investor types (OR-matched). Spaces are normalised to underscores to match stored values.
Comma-separated last funding-round investment types (OR-matched).
Comma-separated NPI investment types (OR-matched).
Comma-separated company UUIDs to restrict results to.
Comma-separated Rings industry tags. Combined per rings_industry_tags_operator (AND requires every tag, OR requires any).
Logical operator for rings_industry_tags. 'AND' (default) requires all tags; 'OR' requires any.
AND, OR Minimum founding year (inclusive).
Maximum founding year (inclusive).
Minimum Rings score (inclusive).
Maximum Rings score (inclusive).
Minimum employee count (inclusive).
Maximum employee count (inclusive).
Minimum overall operating Rings AI score (inclusive).
Maximum overall operating Rings AI score (inclusive).
Minimum overall investor Rings AI score (inclusive).
Maximum overall investor Rings AI score (inclusive).
Start of last funding-round investment date range (ISO 8601 date). Applied with last_investment_date_to.
End of last funding-round investment date range (ISO 8601 date). Applied with last_investment_date_from.
Start of NPI date range (ISO 8601 date). Applied with npi_date_to.
End of NPI date range (ISO 8601 date). Applied with npi_date_from.