Docs/API Reference/Agent Card

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

GET/v1/agent-cardGet agent card as JSON
GET/v1/agent-card/pdfDownload agent card as text document

Authentication

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)

GET/v1/agent-card

Returns 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

ParameterTypeRequiredDescription
use_casestringNoFilter agent card data by use case identifier

Response Structure

FieldTypeDescription
agent_card.identityobjectOrganization ID, name, use case, masked API key, plan
agent_card.governance_postureobjectTotal 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_configurationobjectEngine default PII types and profiles (basis: engine_defaults), not your organization configuration
agent_card.compliance_statusobjectoverall: 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_verificationobjectStatus (anchored or not_anchored), chain, network, last anchor date and total anchors from your anchors
agent_card.operational_statusobjectEmergency shutdown state (operational, degraded, shutdown, or unknown when the state could not be read; treat unknown as not confirmed operational), API status
generated_atstringISO timestamp of generation
versionstringAgent card schema version (currently "1.0")

Example

bash
curl "https://tork.network/api/v1/agent-card?use_case=customer-support" \
  -H "x-tork-api-key: tork_sk_your_api_key"
json
{
  "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

GET/v1/agent-card/pdf

Returns 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

ParameterTypeRequiredDescription
use_casestringNoFilter data by use case identifier

Response Headers

HeaderValue
Content-Typetext/plain
Content-Dispositionattachment; filename="tork-agent-card-{orgId}-{date}.txt"

Document Sections

1.IDENTITY — Organization and agent identification
2.GOVERNANCE POSTURE — Total calls, policy version and last activity; autonomy level and TORKING-X score show as not evidenced
3.PII CONFIGURATION — Engine default types, regional and industry profiles
4.COMPLIANCE STATUS — Not assessed, with Tork features mapped to NIST controls
5.BLOCKCHAIN VERIFICATION — Anchor chain and verification status
6.OPERATIONAL STATUS — Emergency shutdown (UNKNOWN when the state could not be read) and API status

Example

bash
curl "https://tork.network/api/v1/agent-card/pdf" \
  -H "x-tork-api-key: tork_sk_your_api_key" \
  -o agent-card.txt

Error Responses

StatusDescription
401Missing or invalid API key
429Rate limit exceeded
500Internal server error