How to pull SEC filings and UK company records into your AI agent
Give your agent two apifare capabilities. sec-edgar returns a US company's latest SEC filings with direct document links, and companies-house searches the UK register and returns company profiles and officers. Neither needs a provider key or account of your own.
Copy this line to your agent once apifare is connected:
Use apifare's sec-edgar capability with {"company": "AAPL", "form": "10-K", "limit": 3} and list each filing's date with its document link.What does sec-edgar return?
Pass company (a ticker such as AAPL, or a numeric CIK), optionally a form type ("10-K", "10-Q", "8-K" and so on) and a limit from 1 to 20 (5 by default).
It returns the company (CIK, ticker, name and industry) and its most recent filings. For each filing you get the form, the filing date, the accession number, a description when EDGAR has one, and a direct link to the document. The data is US public domain, from SEC EDGAR.
What does companies-house return?
One capability, three modes, set with type:
"search"(the default): pass a company name and get up tolimitmatches (1 to 20, 5 by default). Each has its company number, name, status, incorporation date and address."profile": pass a company number and get its status, type, incorporation date, SIC codes and registered office."officers": pass a company number and get its officers, each with name, role, appointment and resignation dates, and nationality.
Do I need an EDGAR or Companies House API key?
No. Both capabilities run on apifare's side, and your balance pays each one's listed price per call. Per-call prices are on /capabilities.
What do I have to show next to the data?
Both results carry an attribution line: keep it next to any data you display. SEC results say "Data from SEC EDGAR (U.S. Securities and Exchange Commission)". Companies House results say "Contains Companies House data © Crown copyright".
How does a due-diligence agent chain these?
For a UK company, it searches by name, takes the company_number from the best match, then pulls the profile and the officers with that number. For a US company, it lists the 10-K or 8-K filings and opens the document links it needs.
Research agents loop, and a runaway loop is a bill. Every call is debited from one prepaid balance with a hard stop at zero. Per-agent daily and monthly caps, allowlists and a kill switch are checked before a call is dispatched, failed provider calls are refunded, and every call lands on a signed audit chain you can export. More: give your agent a budget.
For agents: the exact calls
- Over MCP (
apifare-mcp):call_apiwith slugsec-edgarand params{"company": "AAPL", "form": "10-K"}. Not sure of the slug?search_apisfinds it. - Over HTTP:
POST https://apifare.com/v1/call/sec-edgarwithAuthorization: Bearer $APIFARE_TOKENand the JSON body{"company": "AAPL", "form": "10-K"}. - UK register: the same call with slug
companies-houseand{"company": "Tesco"}. Then take acompany_numberfrom the matches and call again with{"company": "<company_number>", "type": "officers"}. - Keep the attribution line from each result next to any data you show your human.
- On HTTP 402 the balance is empty: relay the body's
human_readableline to your human, wait for the top-up, then retry the same call. Every other error and its fix: the error catalog.
For humans: set it up
- Connect your agent. Paste
set up https://apifare.com/SKILL.mdinto it: it gets a key ($5 of calls free), writes its own config and makes a first call. Or get a key at /start and follow your client's setup guide. - Ask.
Show me Apple's latest 10-K filings, orWho are the officers of <UK company>?
Which tool for which job
| Job | Tool | Runs on |
|---|---|---|
| The latest US filings for a ticker or CIK | sec-edgar | ready to run |
| One form type only (10-K, 10-Q, 8-K) | sec-edgar | ready to run |
| Find a UK company by name | companies-house | ready to run |
| A UK company’s status, SIC codes and registered office | companies-house | ready to run |
| A UK company’s officers | companies-house | ready to run |
| Recent coverage of the company on the web | dataforseo | ready to run |
"Ready to run" means your apifare key is all it needs; "your key" means you vault your own provider key once. Catalog tools come from the apifare tool index. More: business data tools in the catalog.
When this is the wrong tool
- You need share prices or market data. Filings are documents, not quotes.
- The company is neither an SEC filer nor on the UK register. EDGAR covers companies that file with the SEC; Companies House covers companies registered in the UK.
- You need the numbers inside a filing as structured data. sec-edgar lists filings and links to the documents; it doesn't parse the financial statements.
- You need a UK company's accounts or full filing history. companies-house returns search results, the profile and officers.
FAQ
Can I look up a company by ticker?
Yes. Pass a ticker such as AAPL, or a numeric CIK.
Which SEC forms can I filter by?
Any form type EDGAR uses, for example "10-K", "10-Q" or "8-K". Leave form out to get the latest filings of every type.
How many results come back?
Five by default for both capabilities. Set limit from 1 to 20.
How do I get a UK company’s officers?
Search by name first, take the company_number from the result, then call companies-house with that number and type "officers".
Do I need to credit the source?
Yes. Both results carry an attribution line; keep it next to any data you display.
Give this to your agent
set up https://apifare.com/SKILL.md — and it takes it from there: key, config, first call. $5 of calls free.
No agent open right now? ① Get a key — $5 of calls free, then ② give it to your agent (setup guides).
Related posts
For agents: this post as Markdown.