Agent-readable verification APIs

Trust API for the Agent-to-Agent Economy

Let AI agents, platforms, and applications verify Trusgent IDs, trust scores, agent-ready profiles, and proof-based signals.

Get API Key Read API docs

JSON response

{
  "trusgentId": "TG-S-839201",
  "trustScore": 86,
  "agentReadinessScore": 88,
  "verificationLevel": "VERIFIED",
  "capabilities": [
    "business reception",
    "factory visit ops"
  ],
  "apiVersion": "2026-05-01"
}

What can the Trust API do?

Verify Trusgent ID

Check whether a Trusgent ID is valid and active.

Fetch Agent-readable Profile

Retrieve structured capabilities and profile data.

Fetch Trust Score

Read evidence-based score and verification status.

Fetch Agent-readiness Score

Understand whether a profile is ready for agent recommendation.

Search trusted providers

Find providers by query, country, and type.

Fetch Agent Preview

See how an agent should summarize a Trusgent.

Authentication

Use API keys from your Dashboard. Keys are shown once, stored as hashes, revocable, and tracked with usage logs and monthly limits. Send Authorization: Bearer YOUR_API_KEY.

Endpoints

Current public API surface.

GET /api/v1/verify?trusgentId=TG-C-839201

GET /api/v1/trusgents/{id}

GET /api/v1/trusgents/{id}/trust-score

GET /api/v1/search?q=travel&country=CN&type=SERVICE_PROVIDER

GET /api/v1/agent-preview/{id}

Code examples

curl

curl "https://www.trusgent.com/api/v1/verify?trusgentId=TG-S-839201" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const res = await fetch("https://www.trusgent.com/api/v1/trusgents/TG-S-839201", {
  headers: { Authorization: "Bearer YOUR_API_KEY" }
});
const profile = await res.json();

Python

import requests

res = requests.get(
    "https://www.trusgent.com/api/v1/search?q=travel&country=CN&type=SERVICE_PROVIDER",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(res.json())

Rate limits and plans

Free profiles include basic JSON. Pro and Business unlock broader API access. API plans are for high-volume lookup, bulk query, and integrations.

OpenAPI and llms.txt

Use /openapi.json for machine-readable endpoint documentation and /llms.txt for a concise AI-agent orientation file. These do not guarantee AI ranking; they provide structured discovery foundations.

FAQ

Do I need an API key?

Some public verification endpoints can be read directly; authenticated API usage supports keys, usage logs, and limits.

Where do I create keys?

Dashboard API Keys lets users create and revoke hashed API keys.

Can I search providers?

Yes. The search endpoint supports q, country, and type parameters.

Can I fetch Trust Score?

Yes. Trust Score has a dedicated endpoint with a score breakdown foundation.

Can agents use the API?

Yes. The API is designed for structured retrieval by agents and enterprise systems.

Is there OpenAPI?

Yes. /openapi.json exposes the current public API surface.

Are there monthly limits?

API keys can have monthly limits and usage logs.

Can I bulk query?

Bulk access is intended for API and enterprise plans.