Developer Documentation

Trust API & Registry Discovery

Public, canonical Trust Profiles for companies, products, APIs, and websites, plus a filterable Discovery API for humans and AI agents. Every profile reuses an existing Reliq scan/report's Trust Score — there is one scoring system; the registry never recomputes scores.

API base {TA.api} · App base {TA.site}

{/* Quick nav */}

{nav.map((n) => ( ))}

Public read endpoints need no key. Publishing requires an authenticated session with the share_report feature and RUN_SCANS permission. The MCP endpoint uses an API key (Authorization: Bearer rq_live_…); LIVE keys require the mcp_access feature (Team plan and up).

Rate limits are per 60s window (defaults): public 300, api 120, scan 30. Exceeding a limit returns 429. Responses are wrapped as {"{ data, meta }"}.

Returns the full machine-readable Trust Profile (a .json suffix is accepted). Includes Trust Score, pillars, badges, trend, history, SEO, JSON-LD, and the agent block.

{`curl ${TA.api}/v1/registry/acme-com`}

Filterable, sortable, paginated feed. Filters: kind, minTrust, minAgent, minApi, minDocs, badges (CSV of trust-ready, agent-ready, integration-ready), direction. Sort: trust (default), agent, api, docs, newest, movement. Paginate with limit (max 50) + cursor (from nextCursor).

{`curl "${TA.api}/v1/registry/discover?kind=api&minTrust=75&sort=trust&limit=20"`}

{`{
  "data": {
    "sort": "trust", "count": 1, "hasMore": false, "nextCursor": null,
    "profiles": [{
      "name": "Epsilon API", "slug": "epsilon-api", "kind": "API",
      "canonicalUrl": "${TA.site}/registry/epsilon-api",
      "jsonUrl": "${TA.api}/v1/registry/epsilon-api",
      "trustScore": 91, "grade": "Excellent",
      "pillars": { "release": 90, "security": 95, "agent": 88, "api": 96, "docs": 90 },
      "badges": { "trustReady": true, "agentReady": true, "integrationReady": true },
      "trend": { "movement30d": 3, "direction": "up" },
      "badgeUrls": { "score": "…/badge/score.svg", "trust-ready": "…/badge/trust-ready.svg" },
      "lastVerified": "2026-06-19T00:00:00.000Z"
    }]
  }
}`}

Top N profiles (default 10, max 50) for the same filters/sorts as discovery, without a pagination cursor.

{`curl "${TA.api}/v1/registry/discover/top?sort=agent&limit=5"`}

Returns an image/svg+xml badge reflecting current status. Types: score, trust-ready, agent-ready, integration-ready. Unearned badges render a neutral “unverified” badge rather than failing.

{`curl ${TA.api}/v1/registry/acme-com/badge/score.svg`}

JSON-RPC 2.0 over HTTP with API-key auth. Methods: initialize, ping, tools/list, tools/call. Tools: reliq_check_release_readiness, reliq_check_agent_readiness, reliq_generate_report.

Authenticated. Publish an existing public report as a Trust Profile: validates the slug (unique, safe), caches the Trust Score, and captures an initial Trust History snapshot. Returns the canonical URL, JSON URL, badge URLs, and embed snippets. Re-snapshot via POST /v1/registry/profiles/{"{slug}"}/refresh.

{`curl -X POST ${TA.api}/v1/registry/profiles \\
  -H "Authorization: Bearer " \\
  -H "Content-Type: application/json" \\
  -d '{
    "workspaceId": "wsp_123", "name": "Acme", "kind": "WEBSITE",
    "slug": "acme-com", "websiteUrl": "https://acme.com",
    "reportPublicId": "rep_2k8x"
  }'`}

Every profile JSON includes an agent block for AI agents: trust score, grade, five pillar scores, badges, trend (movement + direction), badge URLs, public report JSON URL, and the discovery API URL.

{`"agent": {
  "trust_score": 72, "grade": "Needs Work",
  "trust_ready": false, "agent_ready": false, "integration_ready": true,
  "pillars": { "release": 78, "security": 90, "agent": 55, "api": 78, "docs": 82 },
  "previous_score": 66, "movement_30d": 6, "movement_90d": 12, "direction": "up",
  "last_verified": "2026-06-20T00:00:00.000Z",
  "report_json_url": "${TA.api}/v1/public/reports/rep_2k8x",
  "badge_urls": { "score": "…/badge/score.svg", "agent-ready": "…/badge/agent-ready.svg" },
  "discovery_url": "${TA.api}/v1/registry/discover"
}`}

Find top agent-ready APIs

{`curl "${TA.api}/v1/registry/discover/top?kind=api&badges=agent-ready&sort=agent&limit=10"`}

Find trust-ready products

{`curl "${TA.api}/v1/registry/discover?kind=product&badges=trust-ready&sort=trust"`}

Get a profile JSON

{`curl ${TA.api}/v1/registry/acme-com.json`}

Embed a Trust Ready badge

{`[![Reliq Trust Ready](${TA.api}/v1/registry/acme-com/badge/trust-ready.svg)](${TA.site}/registry/acme-com)`}

Use Reliq MCP to check agent readiness

{`curl -X POST ${TA.api}/v1/mcp \\
  -H "Authorization: Bearer rq_live_xxx" \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": { "name": "reliq_check_agent_readiness",
                "arguments": { "url": "https://acme.com" } }
  }'`}

{title}

Trust API & Registry Discovery