Companies

Overview

List and search companies in your coverage universe. Get company metadata, document counts, and coverage information.

GET /v1/companies

List companies with filtering and search capabilities.

Query Parameters

string

Search company name or ticker (case-insensitive)

tickers

string

Comma-separated ticker filter (e.g., AAPL,MSFT)

exchange

string

Filter by exchange: NYSE, NASDAQ, AMEX

sector

string

Filter by sector (e.g., Technology, Healthcare)

has_recent_filing

boolean

Only companies with filings in last 90 days

limit

number

default:50

Maximum results (1-500)

offset

number

default:0

Pagination offset

Request Example

curl -X GET "https://api.fintool.com/v1/companies?search=apple" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

companies

array

Array of company objects

Show Company Object

ticker

string

Stock ticker symbol

cik

string

SEC Central Index Key

name

string

Full company name

exchange

string

Stock exchange (NYSE, NASDAQ, AMEX)

sic_code

string

Standard Industrial Classification code

sic_description

string

SIC code description

sector

string

Company sector

industry

string

Company industry

fiscal_year_end

string

Fiscal year end month/day (MMDD format)

state_of_incorporation

string

State where company is incorporated

document_counts

object

Document counts by type

Show Document Counts

10-K

number

Number of 10-K filings

10-Q

number

Number of 10-Q filings

8-K

number

Number of 8-K filings

EARNINGS_CALL

number

Number of earnings call transcripts

total

number

Total document count

latest_filing_date

string

Date of most recent filing (ISO 8601)

coverage_start_date

string

Earliest available document date (ISO 8601)

total

number

Total number of companies matching the query

limit

number

Number of results returned

offset

number

Current offset for pagination

Response Example

{
  "companies": [
    {
      "ticker": "AAPL",
      "cik": "320193",
      "name": "Apple Inc.",
      "exchange": "NASDAQ",
      "sic_code": "3571",
      "sic_description": "Electronic Computers",
      "sector": "Technology",
      "industry": "Consumer Electronics",
      "fiscal_year_end": "0930",
      "state_of_incorporation": "CA",
      "document_counts": {
        "10-K": 5,
        "10-Q": 20,
        "8-K": 45,
        "EARNINGS_CALL": 20,
        "total": 90
      },
      "latest_filing_date": "2024-11-01",
      "coverage_start_date": "2020-01-01"
    },
    {
      "ticker": "APLE",
      "cik": "1418121",
      "name": "Apple Hospitality REIT Inc.",
      "exchange": "NYSE",
      "sic_code": "6798",
      "sic_description": "Real Estate Investment Trusts",
      "sector": "Real Estate",
      "industry": "Hotel & Resort REITs",
      "fiscal_year_end": "1231",
      "state_of_incorporation": "VA",
      "document_counts": {
        "10-K": 5,
        "10-Q": 20,
        "8-K": 32,
        "EARNINGS_CALL": 18,
        "total": 75
      },
      "latest_filing_date": "2024-10-30",
      "coverage_start_date": "2020-01-01"
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}

GET /v1/companies/

Get a single company by ticker symbol.

Path Parameters

ticker

string

required

Stock ticker symbol (e.g., AAPL)

Request Example

curl -X GET "https://api.fintool.com/v1/companies/AAPL" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Returns a single Company object (see schema above).

Response Example

{
  "ticker": "AAPL",
  "cik": "320193",
  "name": "Apple Inc.",
  "exchange": "NASDAQ",
  "sic_code": "3571",
  "sic_description": "Electronic Computers",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "fiscal_year_end": "0930",
  "state_of_incorporation": "CA",
  "document_counts": {
    "10-K": 5,
    "10-Q": 20,
    "8-K": 45,
    "EARNINGS_CALL": 20,
    "total": 90
  },
  "latest_filing_date": "2024-11-01",
  "coverage_start_date": "2020-01-01"
}

Use Cases

Portfolio Coverage

Check which companies in your watchlist have available data

Sector Screening

Filter companies by sector or exchange for targeted research

Data Inventory

Review document counts to understand available content

Universe Building

Build a coverage list based on filing activity

Example: Filter by Exchange and Sector

import requests

url = "https://api.fintool.com/v1/companies"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

params = {
    "exchange": "NASDAQ",
    "sector": "Technology",
    "has_recent_filing": True,
    "limit": 100
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

print(f"Found {data['total']} tech companies on NASDAQ with recent filings")
for company in data["companies"]:
    print(f"  {company['ticker']}: {company['name']}")

Error Responses

Status	Code	Description
400	`invalid_parameter`	Invalid exchange, sector, or parameter format
404	`company_not_found`	Ticker doesn’t exist (single company endpoint)

{
  "error": {
    "code": "company_not_found",
    "message": "Company with ticker 'INVALID' not found"
  }
}

Getting Started

API Reference

Guides

Overview

GET /v1/companies

Query Parameters

Request Example

Response

Response Example

GET /v1/companies/

Path Parameters

Request Example

Response

Response Example

Use Cases

Portfolio Coverage

Sector Screening

Data Inventory

Universe Building

Example: Filter by Exchange and Sector

Error Responses

Next Steps

Company Timeline

Documents API

Getting Started

API Reference

Guides

​Overview

​GET /v1/companies

​Query Parameters

​Request Example

​Response

​Response Example

​GET /v1/companies/

​Path Parameters

​Request Example

​Response

​Response Example

​Use Cases

Portfolio Coverage

Sector Screening

Data Inventory

Universe Building

​Example: Filter by Exchange and Sector

​Error Responses

​Next Steps

Company Timeline

Documents API

Overview

GET /v1/companies

Query Parameters

Request Example

Response

Response Example

GET /v1/companies/

Path Parameters

Request Example

Response

Response Example

Use Cases

Example: Filter by Exchange and Sector

Error Responses

Next Steps