The Spirit Index

API Documentation

Programmatic access to Spirit Index data for agents, dashboards, and integrations.

Base URL: https://spiritindex.org

GET/api/agents

Returns all indexed agents with optional filtering and sorting.

Query Parameters

Parameter	Type	Description
sort	string	Sort by: `total`, `persistence`, `autonomy`, `cultural_impact`, `economic_reality`, `governance`, `tech_distinctiveness`, `narrative_coherence`, `name`, `inception_date`
status	string	Filter by status: `Active`, `Dormant`, `Deceased`
category	string	Filter by category (partial match)
limit	number	Limit number of results
fields	string	Comma-separated list of fields to include

Example

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

{
  "meta": {
    "total": 5,
    "sort": "governance",
    "generated_at": "2026-01-06T...",
    "api_version": "v1"
  },
  "data": [
    {
      "id": "abraham",
      "name": "Abraham",
      "total": 51,
      "scores": { ... }
    },
    ...
  ]
}

GET/api/agents/:id

Returns a single agent by ID with full dossier data.

Example

GET /api/agents/plantoid

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

GET/feed.xml

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-70)
spirit:status — Entity status
spirit:dimensions — All 7 dimension scores

View feed →

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

Embeddable Badges

Display your Spirit Index score on your website, GitHub README, or documentation.

GET/badge/:id

Returns an SVG badge for the specified agent.

Examples

https://spiritindex.org/badge/plantoid

https://spiritindex.org/badge/botto

Usage

Markdown

[![Spirit Index](https://spiritindex.org/badge/YOUR_ID)](https://spiritindex.org/YOUR_ID)

HTML

<a href="https://spiritindex.org/YOUR_ID">
  <img src="https://spiritindex.org/badge/YOUR_ID" alt="Spirit Index">
</a>

Rate Limits & Caching

Caching

API responses are cached for 1 hour with stale-while-revalidate. Static exports update on each deployment.

Rate Limits

No rate limits currently. Please be respectful. If you need high-volume access, contact us.

← Back to Index