# Company Filings & Fundamentals (US)

> Skill `sec-filings` on Faro. 5 sub-skills.

Retrieves official regulatory filings for US public companies, including annual and quarterly reports, earnings announcements, and proxy statements. Use this to access verified financial disclosures and regulatory documents for publicly traded companies, with exact reported figures traceable back to the source filing.

**Category:** Finance & Markets  
**Tags:** sec, edgar, filings, fundamentals, financials  
**Use when:** You need a real reported number or a filing record for a US-listed company, not an estimate.  
**Not for:** Stock prices or quotes, real-time news, analyst estimates, non-US or private companies, full filing text, or insider-trade line items.  
**Returns:** information — Returns reported figures, units, periods, and the filing each traces back to, or a list of filings with links. Not a downloadable file.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/sec-filings/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What is Apple's SEC company identifier?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run sec-filings "What is Apple's SEC company identifier?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What is Apple's SEC company identifier?
- When did Amazon last file its annual report?
- What financial figures has Apple reported in its filings?
- How has Apple's revenue changed over the past 5 years?

## Sub-skills

### Resolve company id

Maps a stock ticker or company name to its official SEC identifier.

**Cost:** 0.1 credits / lookup

**Use when:** You have a ticker or company name and need the identifier the other lookups require.

**Details:** https://askfaro.com/llms/skills/sec-filings/resolve-cik.md

---

### Filing history

Lists a company's filings and finds its latest annual, quarterly, or event report.

**Cost:** 0.1 credits / lookup

**Use when:** You want a company's filing record or a link to its most recent annual, quarterly, or event report.

**Details:** https://askfaro.com/llms/skills/sec-filings/company-filings.md

---

### All reported financials

Pulls all of a company's reported financial facts for discovery or full analysis.

**Cost:** 0.1 credits / lookup

**Use when:** You want the full set of a company's reported figures, or to discover which line items it reports.

**Details:** https://askfaro.com/llms/skills/sec-filings/company-facts.md

---

### One metric over time

Tracks one financial line item for one company across reported periods.

**Cost:** 0.1 credits / lookup

**Use when:** You want one figure, e.g. revenue or net income, traced over quarters and years for a single company.

**Details:** https://askfaro.com/llms/skills/sec-filings/company-metric.md

---

### Cross-company comparison

Returns one financial metric reported by every company for a single period.

**Cost:** 0.1 credits / lookup

**Use when:** You want to compare or rank one reported figure across many companies for one period.

**Details:** https://askfaro.com/llms/skills/sec-filings/frames.md

---

---
On the web: https://askfaro.com/search/sec-filings