Revenues

Corporate revenue data

Beta

Revenues

get

Dataset covering corporate total revenues as reported in official company disclosures, standardized across currencies and fiscal years.

Pricing (depending on the response received):

• 200 (First access to the data): 10

• 200 (Cached data): 1

• 204 (Company did not publish data for the requested year): 1

• Other responses (40x, 50x): Free of charge

Authorizations

BearerAuth

AuthorizationstringRequired

JWT bearer token used for authentication.

Test token (no charges apply; responses contain mock data):

Bearer sk_test_tracenable

Query parameters

tickerstring · min: 1 · max: 15Optional

The stock ticker of the company

Example: AAPL

mic_codestring · enumOptional

The Market Identifier Code (MIC) of the exchange where the company is listed (e.g., XNYS for New York Stock Exchange). If not provided, the first matching ticker will be used.

Example: XNYSPossible values:

company_idstring · uuidOptional

The UUID of the company. If provided, this takes precedence over ticker and mic.

Example: 550e8400-e29b-41d4-a716-446655440000

isinstring · min: 12 · max: 12Optional

The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic.

Example: US0378331005Pattern: ^[A-Z]{2}[A-Z0-9]{9}[0-9]$

leistring · min: 20 · max: 20Optional

The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic.

Example: 5493001KJTIIGC8Y1R12Pattern: ^[A-Z0-9]{18}[0-9]{2}$

reporting_periodintegerRequired

The reporting period for which to retrieve revenue data. Accepts an absolute year (2020..2026) or a negative offset (-6..-1) where -1 resolves to the most recent reporting period available for the company, -2 to the second most recent, etc.

Example: 2023

Responses

200

Revenues

application/json

400

Bad Request

text/plain

401

Unauthorized

text/plain

402

Insufficient credits

text/plain

403

Subscription required

404

No data found for the provided parameters

text/plain

500

Internal Server Error

text/plain

get

/api/v1/revenues

HTTPcURLJavaScriptPython

GET /api/v1/revenues?reporting_period=2023 HTTP/1.1
Host: tracenable.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "year_of_disclosure": 2023,
    "reporting_period": 2023,
    "metric": "Total Revenue",
    "value": 416161000000,
    "ccy": "USD",
    "company_id": "dfb6bd7b-facf-4d0f-86a2-f1eedf191946",
    "document_id": "4a32b902-ae42-4692-ae96-b42c99fdd2f9",
    "traceability_source_url": "https://tracenable.com/source-trace?data-request-id-hash=VraMxIEzmlUw&project=revenues"
  }
]