GET
/
company
/
facts
Get company facts
curl --request GET \
  --url https://api.financialdatasets.ai/company/facts \
  --header 'X-API-KEY: <api-key>'
{
  "company_facts": {
    "ticker": "<string>",
    "name": "<string>",
    "cik": "<string>",
    "industry": "<string>",
    "sector": "<string>",
    "category": "<string>",
    "exchange": "<string>",
    "is_active": true,
    "listing_date": "2023-12-25",
    "location": "<string>",
    "market_cap": 123,
    "number_of_employees": 123,
    "sec_filings_url": "<string>",
    "sic_code": "<string>",
    "sic_industry": "<string>",
    "sic_sector": "<string>",
    "website_url": "<string>",
    "weighted_average_shares": 123,
    "events": [
      {
        "type": "ticker_change",
        "date": "2023-12-25",
        "ticker": "<string>"
      }
    ]
  }
}

​
👋 Overview

Company facts includes data like name, CIK, market cap, total employees, website URL, and more. The company facts API provides a simple way to access the most important high-level information about a company. Please note: This API is experimental and free to use. To get started, please create an account and grab your API key at financialdatasets.ai. You will use the API key to authenticate your API requests.

​
📊 Available CIKs

You can fetch a list of available CIKs with a GET request to: https://api.financialdatasets.ai/company/facts/ciks/

​
🚀 Getting Started

There are only 3 steps for making a successful API call:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Add query params like cik filter the data.
  3. Execute the API request.
Note: You must include the cik in your query params.

​
💻 Example

Company Facts
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
cik = '0000320193'

# create the URL
url = (
    f'https://api.financialdatasets.ai/company/facts'
    f'?cik={cik}'
)

# make API request
response = requests.get(url, headers=headers)

# parse company_facts from the response
company_facts = response.json().get('company_facts')

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string

The ticker symbol.

​
cik
string

The CIK of the company.

Response

200
application/json

Company facts response

The response is of type object.