Financial data

Choose between standardized statements, exact reported tables, and filing sources.

Rangler provides financial statements in two forms. Use standardized financials to compare issuers and periods. Use reported tables when the issuer's exact labels, columns, and printed structure matter.

Integration workflows

Complete ticker-to-financials and filing-to-source request flows with real response examples.

Standardized statements

Consistent metric names, fiscal periods, ratios, currency controls, and optional filing sources.

Exact reported tables

The filing's original row labels and columns, including statements of changes in equity.

Units and currency

Base-unit amounts, decimal percentages, share counts, and explicit FX conversion metadata.

Definitions and formulas

Versioned metric definitions, unit classes, ratio formulas, and calculation dependencies.

Both surfaces require a paid live organization and an API key with the data scope.

Start with a ticker

curl -sG "https://api.rangler.co/v1/financials/statements" \
  -H "X-API-Key: rgl_live_your_key_here" \
  --data-urlencode "ticker=ACCESSCORP" \
  --data-urlencode "country_code=NG" \
  --data-urlencode "granularity=annual" \
  --data-urlencode "latest_only=true" \
  --data-urlencode "include_sources=false" | python3 -m json.tool

country_code is optional when the ticker identifies only one company. Send the ISO 3166-1 alpha-2 market code when a ticker is ambiguous across markets. An unresolved ambiguity returns 409 with code = "ambiguous_ticker".

If your system already stores Rangler company IDs, use:

GET /v1/companies/{company_id}/statement-financials

The ticker and UUID routes return the same response model. The ticker route is the customer-friendly lookup; the UUID route avoids repeated identifier resolution in stored integrations.

Pick the right representation

Requirement	Use
Compare revenue or margins across companies	Standardized statements
Build a period summary or valuation model	Standardized statements
Show the exact label printed by the issuer	Reported tables
Render a source preview or PDF highlight	Source and geometry endpoints
Determine whether one value was reported or calculated	`metric_origins` and `sources`
Discover definitions, units, or formulas	Metric catalog

Standardization does not replace the reported filing. It gives equivalent financial concepts consistent names while keeping links to the source value. See Reported and calculated values to understand how each value was produced.

Response-size defaults

GET /v1/financials/statements defaults include_metadata=false. Its catalog_version identifies the versioned metric catalog used to construct the response; cache that catalog separately instead of downloading definitions with every company.

Use selective queries and include_sources=false for screens or bulk reads. Retrieve filing sources when a customer opens or checks a value.