Agent Card API
Generate AI Bill of Materials (AIBOM) agent cards from your organization's recorded governance activity and blockchain anchors, with Tork features mapped to NIST G-6.1 and Map 3.3. A card is not a compliance assessment.
Endpoints
/v1/agent-cardGet agent card as JSON/v1/agent-card/pdfDownload agent card as text documentAuthentication
Both endpoints require API key authentication. Subject to admin-level rate limiting. Each card served is recorded against your organization and API key, with the route, the use case and the emergency shutdown status. No IP address or user agent is stored.
Get Agent Card (JSON)
/v1/agent-cardReturns an agent card built from your organization's own receipts and anchors. A value with no evidence behind it is null, with a status that says why.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
use_case | string | No | Filter agent card data by use case identifier |
Response Structure
| Field | Type | Description |
|---|---|---|
agent_card.identity | object | Organization ID, name, use case, masked API key, plan |
agent_card.governance_posture | object | Total calls, latest policy version and last activity from your receipts. Autonomy level and TORKING-X score are null until evidenced (torking_x_status: not_evidenced) |
agent_card.pii_configuration | object | Engine default PII types and profiles (basis: engine_defaults), not your organization configuration |
agent_card.compliance_status | object | overall: not_assessed and governance_coverage: null, with a mapping of Tork features to NIST controls that is not an assessment of your organization |
agent_card.blockchain_verification | object | Status (anchored or not_anchored), chain, network, last anchor date and total anchors from your anchors |
agent_card.operational_status | object | Emergency shutdown state (operational, degraded, shutdown, or unknown when the state could not be read; treat unknown as not confirmed operational), API status |
generated_at | string | ISO timestamp of generation |
version | string | Agent card schema version (currently "1.0") |
Example
curl "https://tork.network/api/v1/agent-card?use_case=customer-support" \
-H "x-tork-api-key: tork_sk_your_api_key"{
"agent_card": {
"version": "1.0",
"nist_reference": "NIST AI 600-1 G-6.1, Map 3.3",
"identity": {
"org_id": "org_abc123",
"org_name": "Acme Corp",
"use_case": "customer-support",
"api_key_id": "key_***abc",
"plan": "pro"
},
"governance_posture": {
"autonomy_level": null,
"autonomy_label": null,
"torking_x_score": null,
"torking_x_status": "not_evidenced",
"total_governance_calls": 14250,
"policy_version": "2.1.0",
"last_activity": "2026-02-12T14:30:00Z"
},
"pii_configuration": {
"basis": "engine_defaults",
"types_detected": ["EMAIL", "PHONE", "SSN", "CREDIT_CARD"],
"regional_profiles": ["US", "EU", "GB", "AU"],
"industry_profile": "general"
},
"compliance_status": {
"overall": "not_assessed",
"governance_coverage": null,
"nist_alignment_basis": "feature_mapping_not_an_assessment",
"nist_alignment": ["G-6.1 Agent Card / AIBOM", "Map 3.3 AI System Inventory"],
"note": "This card reports recorded activity. It is not a certification, an audit or a compliance assessment."
},
"blockchain_verification": {
"status": "anchored",
"chain": "solana",
"network": "devnet",
"last_anchor_date": "2026-02-12",
"total_anchors": 45
},
"operational_status": {
"emergency_shutdown": "operational",
"api_status": "operational"
}
},
"generated_at": "2026-02-12T14:35:00Z",
"version": "1.0"
}Download Agent Card
/v1/agent-card/pdfReturns the agent card as a formatted plain-text AIBOM document, with the same figures as the JSON response. It reports recorded activity and is not a certification, an audit or a compliance assessment.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
use_case | string | No | Filter data by use case identifier |
Response Headers
| Header | Value |
|---|---|
Content-Type | text/plain |
Content-Disposition | attachment; filename="tork-agent-card-{orgId}-{date}.txt" |
Document Sections
Example
curl "https://tork.network/api/v1/agent-card/pdf" \
-H "x-tork-api-key: tork_sk_your_api_key" \
-o agent-card.txtError Responses
| Status | Description |
|---|---|
401 | Missing or invalid API key |
429 | Rate limit exceeded |
500 | Internal server error |