Quickstart
One GET returns the witnessed record for a company on the Trooth Network, or the address of its one Trust Profile, with no key and no account. The examples on this page run against the live Trooth application programming interface (API) at api.trooth.co.
# No key, no account. Output abridged; your-co is a placeholder for a real slug.
curl -s https://api.trooth.co/public/trust/your-co
{ "profile": { "displayName": "Your Co", "domain": "your-co.com" } }
# Or read the same record from a terminal.
npx trooth check your-co.com
Read a profile from your code
The public Trust Profile API needs no key or account. It returns a company's published Trust Profile as JSON, a machine-readable format, fetched by its domain or workspace slug: pillar counts, audit-chain evidence, an AI profile and the date of the most recent reading, which is one date for the whole record rather than one per line. The authenticated endpoints that run your dashboard are scoped to your signed-in session and are not offered as a public API. Trooth automates the reading and signs the event; Trooth never signs on a company's behalf.
curl https://api.trooth.co/public/trust/your-coRate limits, and the one documented use of a workspace API key, are on the API reference.
Next steps
Public Trust Profile API
Fetch any listed company's public Trust Profile as JSON, by its domain or its slug.
CLI
Check a company from your terminal, and list what your own infrastructure declares.
Trust Badge
Show your Trust Profile on your own site. The badge reads your record each time the page loads.
Every endpoint, with its limits, is on the API reference.