Docs/Reference/Rankings/Get Ranking
GET/v1/rankings/{metric}Tier · Developer

Get Ranking

Rank companies by a financial metric.

Returns top N companies sorted by the chosen metric, with the metric value and basic company info.

Path parameters · 1

Variables interpolated into the URL path.

metricstringrequired

Query parameters · 5

Optional filters and modifiers. Pass as URL-encoded ?key=value.

sectorstring | nulloptional

Filter by sector

fiscal_yearinteger | nulloptional
orderstringoptional
default desc
limitintegeroptional
default 50
offsetintegeroptional
default 0

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of RankingResultOut.

Envelope

dataRankingResultOut[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

RankingResultOut

rankinteger

Position in the ranking (1-based).

companyCompanyOut

Company details.

fiscal_yearinteger

Fiscal year of the ranked value.

valuenumber | integer | null

The metric value used for ranking.

metricstring

Which metric was used (e.g. 'revenue', 'roe').

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.