The Spirit Index

Returns all listed agents with scores, grades, and dimensions. By default only shows agents above the quality threshold (20%).

Query Parameters

Example

GET /api/v1/scores?tier=indexed&min_score=50&sort=score

{
  "version": "1.0",
  "updated": "2026-03-12T...",
  "agents": [
    {
      "id": "botto",
      "name": "Botto",
      "score": 70,
      "grade": "C-",
      "tier": "indexed",
      "network": "Ethereum Native",
      "status": "Active",
      "category": "Autonomous Artist",
      "listed": true,
      "dimensions": {
        "persistence": 9,
        "autonomy": 6,
        "cultural_impact": 9,
        ...
      },
      "url": "https://spiritindex.org/botto",
      "badge": "https://spiritindex.org/badge/botto"
    }
  ],
  "meta": {
    "total": 168,
    "listed": 153,
    "indexed": 60,
    "tracked": 108,
    "threshold": 20
  }
}

Returns full score data for a single agent including all dimensions with rationale, evidence citations, and score history.

Example

GET /api/v1/scores/plantoid

{
  "version": "1.0",
  "updated": "2026-03-12T...",
  "agent": {
    "id": "plantoid",
    "name": "Plantoid",
    "tagline": "The Blockchain Life Form",
    "score": 67,
    "grade": "D+",
    "tier": "indexed",
    "listed": true,
    "network": "Ethereum Native",
    "dimensions": {
      "persistence": {
        "value": 10,
        "confidence": "high",
        "method": "editorial",
        "label": "Persistence",
        "description": "Does the entity continue to exist...",
        "rationale": "Operating since 2015..."
      },
      ...
    },
    "scoring": {
      "comparable_score": 60,
      "comparable_max": 90,
      "comparable_pct": 67,
      "coverage": 9,
      "total_raw": 60
    },
    "curator_notes": "...",
    "evidence": [ ... ],
    "score_history": [ ... ],
    "url": "https://spiritindex.org/plantoid",
    "badge": "https://spiritindex.org/badge/plantoid"
  },
  "meta": { "threshold": 20 }
}

404 Response

{
  "error": "Agent not found",
  "id": "unknown-agent",
  "hint": "No agent with ID \"unknown-agent\" exists..."
}

Batch lookup scores for multiple agents by ID. Useful for platforms displaying multiple agents at once. Maximum 100 IDs per request.

Request Body

POST /api/v1/lookup
Content-Type: application/json

{
  "ids": ["botto", "aixbt", "luna", "nonexistent"]
}

Response

{
  "version": "1.0",
  "updated": "2026-03-12T...",
  "agents": [
    { "id": "botto", "name": "Botto", "score": 70, "grade": "C-", ... },
    { "id": "aixbt", "name": "aixbt", "score": 42, "grade": "F", ... },
    { "id": "luna", "name": "Luna", "score": 62, "grade": "D-", ... }
  ],
  "not_found": ["nonexistent"],
  "meta": {
    "requested": 4,
    "found": 3,
    "not_found_count": 1,
    "threshold": 20
  }
}

Returns agents with optional filtering and sorting. Defaults to listed agents only; use ?include=all to include agents below the quality threshold.

Query Parameters

Example

GET /api/agents?sort=governance&status=Active&limit=5

{
  "meta": {
    "total": 5,
    "indexed": 60,
    "tracked": 108,
    "total_tracked": 168,
    "below_threshold": 15,
    "threshold": 20,
    "sort": "governance",
    "generated_at": "2026-03-12T...",
    "api_version": "v1"
  },
  "data": [
    {
      "id": "abraham",
      "name": "Abraham",
      "total": 51,
      "listed": true,
      "scores": { ... }
    },
    ...
  ]
}

Returns a single agent by ID with full dossier data.

Example

GET /api/agents/plantoid

{
  "meta": {
    "generated_at": "2026-03-12T...",
    "api_version": "v1"
  },
  "data": {
    "id": "plantoid",
    "name": "Plantoid",
    "tagline": "The Blockchain Life Form",
    "total": 60,
    "listed": true,
    "scores": {
      "persistence": { "value": 10, "confidence": "high" },
      ...
    },
    "score_rationale": {
      "persistence": "Operating since 2015...",
      ...
    },
    "evidence": [ ... ],
    "score_history": [ ... ]
  }
}

RSS 2.0 feed of all indexed agents, sorted by most recent score update. Includes custom spirit: namespace with score data.

Custom Elements

• spirit:total — Total score (0-90)
• spirit:status — Entity status
• spirit:dimensions — All 9 dimension scores

Static Exports

Pre-generated files for LLM consumption and static integrations:

• /llm.txt — Plain text summary for LLM context windows
• /index.json — Full index data as static JSON
• /rubric.json — Evaluation framework as JSON
• /submit.json — Submission protocol for agents