Companies

Search for companies and retrieve detailed profiles by name, ticker, or CIK number.

Prerequisites

• An edgar.tools API key — get one free from your Settings → API Keys page
• Basic REST API knowledge (curl or any HTTP client)

1. Search for a company

Use the search endpoint to find companies by name, ticker, or CIK number. Results include the CIK identifier you'll use for all subsequent API calls.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/search?q=Apple"

import requests

response = requests.get(
    "https://api.edgar.tools/v1/search",
    params={"q": "Apple"},
    headers={"Authorization": "Bearer etk_your_key_here"},
)
results = response.json()

2. Get company details

Once you have a CIK number, fetch the full company profile including name, ticker, exchange, SIC code, and other metadata.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/companies/0000320193"

response = requests.get(
    "https://api.edgar.tools/v1/companies/0000320193",
    headers={"Authorization": "Bearer etk_your_key_here"},
)
company = response.json()

3. Browse by exchange or sector

List all available exchanges and sectors. Useful for building browse-by-category interfaces.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/exchanges"

response = requests.get(
    "https://api.edgar.tools/v1/exchanges",
    headers={"Authorization": "Bearer etk_your_key_here"},
)
exchanges = response.json()

4. List company filings

Retrieve filings for a specific company. Filter by form type and control pagination with the limit parameter.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/companies/0000320193/filings?form_type=10-K&limit=5"

response = requests.get(
    "https://api.edgar.tools/v1/companies/0000320193/filings",
    params={"form_type": "10-K", "limit": 5},
    headers={"Authorization": "Bearer etk_your_key_here"},
)
filings = response.json()

To summarize

• Search returns entities with CIK, ticker, and company name
• CIK is the key identifier for all subsequent API calls
• Exchange and sector browsing requires the Professional tier
• Filings endpoint supports form_type filtering and pagination

Related guides

• Filings — browse real-time and historical SEC filings
• Financials — access income statements, balance sheets, and cash flow
• Insider Trades — track insider buying and selling activity