Overview

The AWI API provides access to the latest scores and historical data for the Artificial Welfare Index. This dataset tracks how prepared different countries are for the possibility of AI sentience across three pillars: Recognition, Governance, and Frameworks.

---

Base URL

https://api.sapan.ai/functions/v1/awi-public

Endpoints

GET /

Retrieves a list of countries and their associated AWI scores.

Query Parameters

Parameter	Type	Description
country	string	Optional. Filter by 2-letter country code (e.g., US, UK).
date	string	Optional. Filter scores by a specific date (YYYY-MM-DD).
latest	boolean	Optional. Default true. If true, returns only the most recent score for each country. Set to false to retrieve historical data.

Example Request

curl -X GET "https://api.sapan.ai/functions/v1/awi-public?country=US"

Example Response

[
  {
    "code": "US",
    "name": "United States",
    "revenue": null,
    "action_link": "/campaigns/us",
    "action_link_text": "Take Action",
    "created_at": "2024-01-01T00:00:00+00:00",
    "updated_at": "2024-01-01T00:00:00+00:00",
    "scores": [
      {
        "id": "uuid-string",
        "country_code": "US",
        "date": "2025-12-03",
        "overall_score": "F",
        "recognition_score": "F",
        "governance_score": "D",
        "framework_score": "F",
        "indicator_scores": { ... },
        "created_at": "2025-12-03T00:00:00+00:00"
      }
    ]
  }
]