Score Batch
Score multiple applicants in a single request. Accepts up to 1,000 records per batch. Each record contains the applicant's feature values and an optional identifier for correlating results.
score scope. Pass via Authorization: Bearer sk_test_xxxPath Parameters
The deployment slug (e.g. dep_xK8m).
Body Parameters
Array of applicant objects. Each object contains feature key-value pairs and an optional id field for correlating results. Maximum 1,000 records per request.
When true, reject the entire batch if any record has missing or unrecognized features. Defaults to false.
Include per-feature score contributions for each record. Defaults to false to reduce payload size for large batches.
Error Responses
The API key is missing, expired, or does not have the score scope.
No active deployment matches the provided slug.
The batch exceeds the maximum of 1,000 records per request.
Too many requests. Check the Retry-After header.
curl -X POST https://api.cali-br.com/v1/score/dep_xK8m/batch \
-H #a5d6ff">"Authorization: Bearer sk_test_abc123" \
-H #a5d6ff">"Content-Type: application/json" \
-d '{
#a5d6ff">"records": [
{
#a5d6ff">"id": "applicant_001",
#a5d6ff">"annual_income": 72000,
#a5d6ff">"debt_to_income": 0.25,
#a5d6ff">"months_employed": 60
},
{
#a5d6ff">"id": "applicant_002",
#a5d6ff">"annual_income": 38000,
#a5d6ff">"debt_to_income": 0.55,
#a5d6ff">"months_employed": 12
}
],
#a5d6ff">"include_contributions": true
}'{
"results": [
{
"id": "applicant_001",
"score": 712,
"risk_grade": "A",
"pd": 0.0198,
"contributions": { "annual_income": 52, "debt_to_income": -8 },
"warnings": []
},
{
"id": "applicant_002",
"score": 541,
"risk_grade": "D",
"pd": 0.1234,
"contributions": { "annual_income": 18, "debt_to_income": -35 },
"warnings": ["missing_feature: months_employed"]
}
],
"model_version": "1.2.0",
"deployment_id": "dep_xK8m",
"total": 2,
"scored_at": "2026-03-26T14: 30: 00Z",
"request_id": "req_batch_789xyz"
}