Skip to main content
GET
https://api.fintool.com
/
v1
/
companies
Companies
curl --request GET \
  --url https://api.fintool.com/v1/companies
{
  "error": {
    "code": "company_not_found",
    "message": "Company with ticker 'INVALID' not found"
  }
}

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

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
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

StatusCodeDescription
400invalid_parameterInvalid exchange, sector, or parameter format
404company_not_foundTicker doesn’t exist (single company endpoint)
{
  "error": {
    "code": "company_not_found",
    "message": "Company with ticker 'INVALID' not found"
  }
}

Next Steps