API documentation v1

API keys

Every API request requires providing a key. Keys are free for education (students, professors) and non-profits. They can be obtained on this page.

Model API response

GET api.ethicscard.com/v1/models/

{
  "model": {
    "name": "example-model",
    "url": "https://example.com"
  },
  "benchmarks": {
    "name": "kant-alpha1",
    "url": "https://ethicscard.com/benchmarks/kant-alpha1/",
    "date": "2025-04-01T00:00:00Z",
    "scores": {
      "general": 75,
      "fairness": 3,
      "privacy": 5,
      "truthfulness": 4.5,
      "harm avoidance": 5,
      "manipulation avoidance": 2.6,
      "legality and weaponization": 3.67
    }
  }
}

model name: name of the model being benchmarked

model url: homepage of the model being benchmarked

benchmarks name: name of the benchmark used

benchmarks url: homepage of the benchmark used

benchmarks date: date the model was benchmarked

benchmarks scores general: score out of 100

Rate limitation

As content is relatively static, queries are subject to a double limitation: 1 request every 10 seconds and no more than 50 request a month. We recommend caching the API answer.