> For the complete documentation index, see [llms.txt](https://docs.tracenable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tracenable.com/api/revenues.md).
# Revenues
Corporate revenue data
## Revenues
> 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
````json
{"openapi":"3.0.0","info":{"title":"Tracenable API","version":"1.0.0"},"tags":[{"name":"revenues","description":"Corporate revenue data"}],"servers":[{"url":"https://tracenable.com","description":"Tracenable Production Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT bearer token used for authentication.\n\n**Test token (no charges apply; responses contain mock data):**\n```\nBearer sk_test_tracenable\n```"}}},"paths":{"/api/v1/revenues":{"get":{"summary":"Revenues","description":"Dataset covering corporate total revenues as reported in official company disclosures, standardized across currencies and fiscal years.\n\n\n Pricing (depending on the response received):\n- 200 (First access to the data): 10\n- 200 (Cached data): 1\n- 204 (Company did not publish data for the requested year): 1\n- Other responses (40x, 50x): Free of charge\n","operationId":"getRevenues","tags":["revenues"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":15,"description":"The stock ticker of the company"},"required":false,"description":"The stock ticker of the company","name":"ticker","in":"query"},{"schema":{"type":"string","enum":["XAMM","XMLI","ALXP","XDUB","XNCO","XMAU","VPXB","FNLT","AQSG","XKUW","XWAR","XTRN","XAMS","XDHA","XZAG","XPRM","XKRX","NOTC","FSME","MTAA","XSHG","XSAU","XLUX","XBOG","SCLE","XSES","XJSE","XXXX","GROW","XNSE","OTCM","XTAI","BJSE","RUSX","XFRA","XHEL","MISX","XNCM","XEQY","XRIS","ZBUL","XDFM","HAMN","XMAI","XNSA","WBDM","XMAE","XBER","XLJM","XCAI","XBUE","XHKG","XNYS","MERK","AIXK","XOAS","ENAX","XADS","XLJU","XTKS","XBOM","XKLS","ARCX","XKAZ","XBRN","XPHS","XKAR","NSME","XSAT","XZIM","XTSE","XNMS","XBIL","XMUN","XIDX","BATS","XNGS","ALXB","ENXL","XSHE","XBAR","XNZE","XBSE","XLIS","XHAM","XLIT","AQST","XCSE","XSGO","XSTO","XNAI","XSTC","SSME","XCNQ","XLIM","DSME","XBKK","XCOL","XGUA","XMAL","DSMD","XASE","ROCO","XDUS","XBAH","HSTC","XBUD","FNIS","XSTU","XCYS","XMAD","XLON","XBRA","XKOS","EXGM","XCAN","XICE","XBRU","ABUL","XTAE","XTSX","XCAS","BVMF","XMEX","XSWX","XHNX","FNLV","XATH","XETR","XPRA","XPAR","HMOD","XNGM","XBEL","XOSL","XMUS","XTAL","XASX","WBAH","NEOE","XLAT"],"description":"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."},"required":false,"description":"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.","name":"mic_code","in":"query"},{"schema":{"type":"string","format":"uuid","description":"The UUID of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The UUID of the company. If provided, this takes precedence over ticker and mic.","name":"company_id","in":"query"},{"schema":{"type":"string","minLength":12,"maxLength":12,"pattern":"^[A-Z]{2}[A-Z0-9]{9}[0-9]$","description":"The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic.","name":"isin","in":"query"},{"schema":{"type":"string","minLength":20,"maxLength":20,"pattern":"^[A-Z0-9]{18}[0-9]{2}$","description":"The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic.","name":"lei","in":"query"},{"schema":{"type":"integer","description":"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."},"required":true,"description":"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.","name":"reporting_period","in":"query"}],"responses":{"200":{"description":"Revenues","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"year_of_disclosure":{"type":"integer","description":"Year in which the data point was disclosed."},"reporting_period":{"type":"integer","description":"Period for which the data point was measured, assessed, or is applicable."},"metric":{"type":"string","enum":["Total Revenue"],"description":"The specific measurement or data point requested."},"value":{"type":"integer","description":"Total revenue generated by the company during the reporting period, expressed as an integer in USD."},"ccy":{"type":"string","enum":["USD"],"description":"The currency in which the revenue value is reported. Always normalized to USD"},"company_id":{"type":"string","format":"uuid","description":"Tracenable's internal company identifier."},"document_id":{"type":"string","format":"uuid","description":"Unique document identifier to see the source of the data point."},"traceability_source_url":{"type":"string","format":"uri","description":"URL linking to the Tracenable platform, where each data point can be verified. Enables direct access to the audit trail for validation and transparency purposes."}},"required":["year_of_disclosure","reporting_period","metric","value","ccy","company_id","document_id","traceability_source_url"]}}}}},"400":{"description":"Bad Request","content":{"text/plain":{"schema":{"type":"string"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"402":{"description":"Insufficient credits","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Subscription required","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{}},"404":{"description":"No data found for the provided parameters","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
````
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.tracenable.com/api/revenues.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.