Documentation · Endpoints
AUROS Green API — CQS, Watt & Index
API publique Green : score unifié, bulk, analyse texte, index et batch CQS. 100 req/jour anon, 1000/mois avec clé free.
GET score unifié (recommandé)
Endpoint principal — CQS + Watt + composite + rang Green Index.
100 req/jour sans clé · 1000/mois avec clé free (`POST /api/v1/keys`).
Hub complet : /green/api · OpenAPI : /api/green/openapi
curl https://getauros.com/api/green/score/toucan
GET bulk & POST analyze
Bulk : `GET /api/green/scores?ids=toucan,moss` (max 5 anon, 20 avec clé).
Due diligence texte : `POST /api/green/score/analyze` body `{ "text": "Gold Standard forestry…" }`.
curl "https://getauros.com/api/green/scores?ids=toucan,moss"
curl -X POST https://getauros.com/api/green/score/analyze \
-H "Content-Type: application/json" \
-d '{"text":"Verra REDD+ credits retired 2024 on-chain"}'GET CQS seul (legacy)
Une référence comparateur Green (`toucan`, `moss`, `klim`…) — préférez `/api/green/score/{id}`.
curl https://getauros.com/api/green/carbon-quality/toucan
GET Registry Connect (serial → CQS)
Entrez un serial **Verra VCS**, **Gold Standard** ou **Puro** — CQS + Nature Score + liens registre.
v1 : ingestion live Verra/GS/Puro quand disponible · catalog pilote sinon inférence.
Gratuit : `GET /api/green/registry?serial=VCS-674` · Hub : /green/registry-connect
curl "https://getauros.com/api/green/registry?serial=VCS-674" curl "https://getauros.com/api/green/registry?registry=gold_standard&serial=5678" curl "https://getauros.com/api/green/registry?registry=puro&serial=PURO-1001"
POST batch CQS (clé API)
Jusqu'à **10 crédits** (free) ou **50** (premium) par appel.
`id` = référence comparateur AUROS, ou `text` = description libre (min 10 caractères).
Serial Registry Connect : `{ "serial": "VCS-674" }`. Upgrade : /green/api
curl -X POST https://getauros.com/api/v1/green/carbon-quality/batch \
-H "Authorization: Bearer auros_pk_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"items":[{"id":"toucan"},{"text":"Gold Standard forestry credits retired 2024 Verra"}]}'Embed presse / partenaires
Widget iframe sans authentification — lien « Powered by AUROS » inclus.
Widget JS 1-ligne : `<script src="…/green-score.js" defer></script>` + `data-auros-green-score data-id="toucan"`.
Voir aussi /data/green-index et l'API Watt (/developers/docs/endpoint-green-watt).
<iframe src="https://getauros.com/embed/green-score?id=toucan" width="320" height="160"></iframe> <script src="https://getauros.com/green-score.js" defer></script> <div data-auros-green-score data-id="toucan"></div>
GET Nature Index & Nature Score
Classement biodiversité : `GET /api/green/nature-index` · page `/data/nature-score`.
Score unitaire TNFD : `GET /api/green/nature-score/{id}` (moss, regen-network…).
curl https://getauros.com/api/green/nature-index curl https://getauros.com/api/green/nature-score/moss
GET DPP Bridge (JSON-LD)
Passeport produit EU v0 — `GET /api/green/dpp/{id}` ou `?format=jsonld` pour LD+JSON.
curl https://getauros.com/api/green/dpp/toucan curl "https://getauros.com/api/green/dpp/toucan?format=jsonld"
GET historique score (Premium)
12 mois indicatifs CQS/Watt/composite — clé tier premium ou enterprise.
HTTP 402 `premium_required` si clé free.
curl https://getauros.com/api/green/score/toucan/history \ -H "Authorization: Bearer auros_pk_live_xxx"
SDK
Python : `client.green_carbon_quality("toucan")`, `client.green_carbon_quality_batch(items=[...])`.
const cqs = await client.greenCarbonQuality("toucan");
const batch = await client.greenCarbonQualityBatch({
items: [{ id: "toucan" }, { text: "Gold Standard credits retired CCP" }],
});