Skip to main content
GET
List companies.

Authorizations

x-api-key
string
header
required

Query Parameters

page
integer
default:1

Page number, 1-indexed. Clamped to >= 1.

per_page
integer
default:50

Results per page. Clamped to the range 1-100 (values outside are silently capped, not rejected).

name
string | null

Case-insensitive substring match on company name.

linkedin_url
string | null

Exact match on the company's LinkedIn URL.

domain
string | null

Website domain to match (e.g. 'acme.com'), same semantics as the domain parameter on GET /v1/companies/lookup.

modified_since
string | null

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.

sort_by
enum<string> | null

Field to sort by. Valid values: 'name', 'last_activity_date'

Available options:
name,
last_activity_date
order
enum<string>
default:asc

Sort order. Valid values: 'asc' (ascending) or 'desc' (descending)

Available options:
asc,
desc
description
string | null

Case-insensitive substring match on description.

facebook_url
string | null

Case-insensitive substring match on facebook_url.

twitter_url
string | null

Case-insensitive substring match on twitter_url.

city
string | null

Case-insensitive substring match on city.

state
string | null

State/region name; resolved via pycountry and matched exactly against the stored canonical name (scoped to country when provided).

country
string | null

Country name or code; resolved via pycountry and matched exactly against the stored canonical name.

operating_status
string | null

Comma-separated operating statuses (OR-matched).

acquisition_status
string | null

Comma-separated acquisition statuses (OR-matched).

ipo_status
string | null

Comma-separated IPO statuses (OR-matched).

investor_types
string | null

Comma-separated investor types (OR-matched). Spaces are normalised to underscores to match stored values.

last_investment_types
string | null

Comma-separated last funding-round investment types (OR-matched).

npi_types
string | null

Comma-separated NPI investment types (OR-matched).

uuids
string | null

Comma-separated company UUIDs to restrict results to.

rings_industry_tags
string | null

Comma-separated Rings industry tags. Combined per rings_industry_tags_operator (AND requires every tag, OR requires any).

rings_industry_tags_operator
enum<string>
default:AND

Logical operator for rings_industry_tags. 'AND' (default) requires all tags; 'OR' requires any.

Available options:
AND,
OR
founded_on_from
integer | null

Minimum founding year (inclusive).

founded_on_to
integer | null

Maximum founding year (inclusive).

score_from
number | null

Minimum Rings score (inclusive).

score_to
number | null

Maximum Rings score (inclusive).

employee_count_from
integer | null

Minimum employee count (inclusive).

employee_count_to
integer | null

Maximum employee count (inclusive).

overall_operating_score_from
number | null

Minimum overall operating Rings AI score (inclusive).

overall_operating_score_to
number | null

Maximum overall operating Rings AI score (inclusive).

overall_investor_score_from
number | null

Minimum overall investor Rings AI score (inclusive).

overall_investor_score_to
number | null

Maximum overall investor Rings AI score (inclusive).

last_investment_date_from
string | null

Start of last funding-round investment date range (ISO 8601 date). Applied with last_investment_date_to.

last_investment_date_to
string | null

End of last funding-round investment date range (ISO 8601 date). Applied with last_investment_date_from.

npi_date_from
string | null

Start of NPI date range (ISO 8601 date). Applied with npi_date_to.

npi_date_to
string | null

End of NPI date range (ISO 8601 date). Applied with npi_date_from.

Response

200 - application/json

Paginated list of companies.

items
CompanyResponse · object[]
required
page
integer
required
per_page
integer
required
total
integer
required