Recipe · per call
Vet a new supplier for two cents
Before you pay a new UK supplier: confirm the company exists, is active and files on time, and screen its name against the US sanctions list. Two calls, one short note.
What you get
- Company
- TESCO PLC, a public limited company. Status: Active.
- Age
- Incorporated 1947-11-27. Two earlier names; the last change was on 1983-08-25.
- Filings
- Accounts made up to 2026-02-28, next due 2027-08-26. Confirmation statement dated 2026-06-18, next due 2027-07-02. Nothing overdue.
- Address
- Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA.
- Sanctions
- TESCO PLC: no match on the OFAC SDN list (19,563 entries, published 2026-11-09).
- Flags
- None.
To show what a hit looks like, the same call also screened a name that is on the list. BANK MELLI IRAN came back with three matches: an exact match on the primary name (programs IRAN, SDGT, IFSR), an exact match on an alias of a second entity, and a 0.93 token match on an alias of a third.
Claude wrote the note from the two answers of one real run on 2026-11-10, using the prompt below. Every fact is copied from the answers. Download the two answers.
The two calls
One call reads the company's public record at Companies House by its company number. The other screens up to ten names against the US Treasury's OFAC list. Together they cost $0.02.
| Signal | Endpoint | Body | Price |
|---|---|---|---|
| Company record | POST /v1/uk/companies-house/company | {"companyNumber": "00445790"} | $0.01 |
| Sanctions screen | POST /v1/sanctions/ofac | {"names": ["TESCO PLC", "BANK MELLI IRAN"]} | $0.01 |
Run it
Save this as vet-supplier.sh, put in your supplier's company number and name, and run it.
#!/bin/sh
# vet-supplier.sh: 2 paid calls, $0.02 in total. Answers land in ./vet-YYYY-MM-DD/
set -eu
API=https://api.ssh.autos/v1
OUT="vet-$(date +%F)"
mkdir -p "$OUT"
call() { npx agentcash@latest fetch "$API/$1" -m POST -b "$2" > "$OUT/$3.json"; }
call uk/companies-house/company '{"companyNumber": "00445790"}' registry
call sanctions/ofac '{"names": ["TESCO PLC", "BANK MELLI IRAN"]}' sanctions
echo "Saved 2 answers to $OUT/"Running it is $0.02 of paid calls. We ran this exact script on 2026-11-10.
Hand the answers to your agent
Read registry.json and sanctions.json in today's vet-YYYY-MM-DD/ folder and write a supplier note of at most 100 words with these lines: Company, Age, Filings, Address, Sanctions, Flags.
Raise a flag when any of these is true:
- the status is anything other than Active;
- accounts or the confirmation statement are past their due date today;
- the company was incorporated less than 12 months ago;
- its name changed in the last 24 months;
- the sanctions screen returned any match. Give the listed name, programs, match type and score.
Copy every name, date and number exactly. If nothing is flagged, write "None". This is a screening aid, not a legal determination: say so when there is a sanctions match.Good to know
- The sanctions call takes up to ten names, so a list of ten suppliers is still one cent.
- Fuzzy matches need a person. A 0.93 token match is a reason to look, not a finding.
- The company record covers the profile only: directors and filing documents are not included.
- This recipe is for UK companies. The catalog has registries for other countries, and the same sanctions call works with any of them.
- The OFAC list is refreshed every 12 hours; each answer states its publication date.
Sources in this recipe
-
UK Companies House Companies, Officers and Filings
Search UK companies and export profiles, officers and filing metadata from public Companies House pages.
-
Sanctions screening against the OFAC SDN list
Screen up to 10 person or company names against OFAC's Specially Designated Nationals list, primary names and aliases, from the US Treasury's own published files…
Machine-readable: openapi.json · llms.txt