Documentation · Endpoints
POST /api/v1/score/batch
Score jusqu'à 20 actifs en un appel — succès partiel par item, 1 unité de quota par batch.
Requête
Tableau `items` (1–20) : chaque élément accepte le même schéma que POST /score.
Option batch `record_history` s'applique à tous les items sauf override par item.
**Quota :** 1 batch = **1 requête** mensuelle (pas N items) — avantage institutionnel vs appels unitaires.
{
"record_history": true,
"items": [
{ "description": "Entrepôt retail Luxembourg €2.5M SPV professionnels" },
{
"asset_type": "bonds",
"issuer_type": "company_spv",
"whitepaper": "draft",
"has_kyc": true
}
]
}Succès partiel
HTTP 200 même si certains items échouent la validation.
Items valides : résultat score complet + `score_id` + `history_url`.
Items invalides : `{ "index": N, "ok": false, "error": { "code", "message" } }`.
{
"total": 2,
"succeeded": 1,
"failed": 1,
"items": [
{
"index": 0,
"ok": true,
"score_id": "scr_a1b2c3d4e5f6789012345678",
"history_url": "https://getauros.com/api/v1/score/scr_a1b2c3d4e5f6789012345678/history",
"score": 72,
"grade": "B-"
},
{
"index": 1,
"ok": false,
"error": {
"code": "validation_error",
"message": "Provide description or structured asset/compliance fields"
}
}
]
}cURL
curl -X POST https://getauros.com/api/v1/score/batch \
-H "Authorization: Bearer auros_pk_test_demo" \
-H "Content-Type: application/json" \
-d '{"items":[{"description":"Entrepôt Luxembourg SPV professionnels"},{"asset_type":"bonds","issuer_type":"company_spv"}]}'SDK
const batch = await client.scoreBatch({
items: [
{ description: "Entrepôt Luxembourg SPV professionnels" },
{ asset_type: "bonds", issuer_type: "company_spv" },
],
});
console.log(batch.succeeded, batch.items[0]?.score_id);