POST https://opencorporates.com/reconcile with Content-Type: application/x-www-form-urlencoded and body queries={"q0":{"query":"Acme Corp","properties":[{"p":"jurisdiction_code","v":"us_de"}]}} and api_token=YOUR_TOKEN
Parse response.q0.result[] sorted by score descending; each candidate includes id (canonical URL), name, score, and match (boolean indicating high-confidence single match)
For candidates with match:false and score above your threshold, present to a human reviewer or apply secondary disambiguation logic
Use the canonical id URL to fetch full company details by appending .json, e.g., GET https://opencorporates.com/companies/us_de/1234567.json?api_token=YOUR_TOKEN
Batch up to 10 queries per POST request in the queries JSON object (keys q0 through q9) to minimize round-trips
Log unmatched names (empty result arrays) for manual SOS lookup or fallback to Cobalt Intelligence
Known gotchas
The reconciliation API requires an API token even for small volumes; unauthenticated requests return HTTP 401
Score values are scaled 0–100 but are not probabilities; a score of 80 does not mean 80% confidence — calibrate your acceptance threshold empirically against known-good test cases
Legal suffixes ('Inc', 'LLC', 'Ltd') affect matching; normalize or strip suffixes before querying to improve recall on name variants
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp