Company Financials Endpoint

The `/company/financials` endpoint allows you to retrieve comprehensive fundamental financial data for a given publicly traded company. This data includes balance sheets, income statements, and cash flow statements.

Parameters:

  • ticker: The ticker symbol for the company.
  • apikey: Your API key for accessing this endpoint. Get one here.
  • filetype: The desired file format for the data. Currently supports "csv", defaults to JSON if not specified.
  • period: The reporting period for the financial data. Can be 'Q' for quarterly or 'A' for annual. Defaults to annual if not specified.

Make A Request

ticker*
filetype
period
https://api.datajockey.io/v0/company/financials?apikey=YOUR_KEY

Please fill the parameters above to build the URL. Parameters marked with a * are mandatory.

Example Response:

{
  "ticker": "AAPL",
  "currency": "USD",
  "company_info": {
    "CIK": "0000320193",
    "ticker": "AAPL",
    "name": "Apple Inc."
  },
  "financial_data": {
    "annual": {
      "revenue": {
        "2007": 24578000000,
        "2008": 37491000000,
        "2009": 42905000000,
        ...
      },
      "cost_of_revenue": {
        "2009": 25683000000,
        ...
      },
      "gross_profit": {
        "2009": 17222000000,
        ...
      },
      "operating_income": {
        "2009": 11740000000,
        ...
      },
      "total_assets": {
        "2009": 53851000000,
        ...
      },
      // additional items
    },
  }
}

Error Responses:

  • 400 Bad Request: The request was malformed or missing required parameters.
  • 401 Unauthorized: The API key provided was invalid or missing.
  • 429 Too Many Requests: The rate limit for this endpoint has been exceeded. Wait and try again later.

Beta and Rate Limiting:

Please note that this endpoint is still in beta, and the returned financial data should be used for testing purposes only. Our API uses rate limiting to ensure fair usage. Rate limits are based on the user's account type. For the free plan, the rate limit is set to 10 requests per minute. If you exceed this limit, you will receive a `429 Too Many Requests` error. Please wait and try your request again later.

Further Assistance:

If you have any questions or need further assistance, please do not hesitate to contact us.