AUROS Protocol

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);

← Retour à la documentation