API REST · DOI 10.5281/zenodo.23400341

Documentation API

An open, citable, and documented REST API to query the 250 biases, 68 Regulations, and 21 analytical views of the IBI database.

44
Exposed relations
17
Fonctions RPC
20
Linked relations
REST
PostgREST 16.4

Endpoints

Main entry points

The API follows the PostgREST specification: each table and view is automatically exposed as REST. Filtering, sorting, and column selection are done via the URL.

MethodEndpointDescription
GET/biaisComplete list of 250 biases
GET/biais?ibi_id=eq.IBI-0002Filter by IBI identifier
GET/v_top_biais_critiquesTop most critical biases
GET/v_api_biais_listeSynthetic list (API format)
GET/v_api_rechercheFull-text search
GET/reglementationsLes 68 Regulations mondiales
GET/v_api_regulationsRegulations formatées
POST/rpc/recherche_biaisRecherche par mot-clé (RPC)
POST/rpc/recherche_triaxisRecherche par Axes TriAxis (RPC)

Exemples

Quick usage

Here are some concrete examples to query the API. Base URL : http://localhost:3000 (dev) ou https://api.ai-biais-initiative.org (prod).

⚡Curl - List 10 biases

curl "http://localhost:3000/biais?limit=10"

⚡Curl - Bias by identifier

curl "http://localhost:3000/biais?ibi_id=eq.IBI-0002"

🐍Python - Search via RPC

import requests

r = requests.get(
    "http://localhost:3000/rpc/recherche_biais",
    params={"terme": "proxy", "limite": 5}
)
for biais in r.json():
    print(biais["ibi_id"], "-", biais["nom_fr"])

🐍Python - Top critical biases

import requests

r = requests.get(
    "http://localhost:3000/v_top_biais_critiques",
    params={"limit": 5}
)
for b in r.json():
    print(b["ibi_id"], b["score_ibi"], b["nom_fr"])

📚Available PostgREST filters

?limit=10 - Limit the number of results
?offset=20 - Pagination
?order=score_ibi.desc - Descending sort
?select=ibi_id,nom_fr - Column selection
?severite=eq.5_critique - Equality filter
?score_ibi=gte.8 - Greater than or equal filter

SPECIFICATION

Complete OpenAPI Spec

The entire API is described in an OpenAPI 3.0 file automatically generated by PostgREST. Importable into Postman, Swagger UI, Insomnia, or any other compatible client.

openapi.json
{
  "openapi": "3.0.0",
  "info": {
    "title": "AI BIAIS Initiative API",
    "version": "1.0.0",
    "description": "API REST sur les biais de l'IA"
  },
  "servers": [
    { "url": "https://api.ai-biais-initiative.org" }
  ],
  "paths": {
    "/biais": { ... },
    "/reglementations": { ... },
    "/rpc/recherche_biais": { ... }
  }
}

Citation

Cite the API in your work

The API has a Zenodo DOI. Please cite it if you use this data in a scientific publication, report, or project.

@software{sidibe_2026_ia_biais,
  author    = {SIDIBE, Mohamadou},
  title     = {AI BIAIS Initiative - API REST},
  year      = 2026,
  publisher = {Zenodo},
  version   = {1.0.0},
  doi       = {10.5281/zenodo.23400341},
  url       = {https://doi.org/10.5281/zenodo.23400341}
}

Let's build together

You use the API? You have suggestions? You want to contribute to enriching the database? Contact us.