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.
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.
| Method | Endpoint | Description |
|---|---|---|
| GET | /biais | Complete list of 250 biases |
| GET | /biais?ibi_id=eq.IBI-0002 | Filter by IBI identifier |
| GET | /v_top_biais_critiques | Top most critical biases |
| GET | /v_api_biais_liste | Synthetic list (API format) |
| GET | /v_api_recherche | Full-text search |
| GET | /reglementations | Les 68 Regulations mondiales |
| GET | /v_api_regulations | Regulations formatées |
| POST | /rpc/recherche_biais | Recherche par mot-clé (RPC) |
| POST | /rpc/recherche_triaxis | Recherche 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 filterSPECIFICATION
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": "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.