Scoring

Score Applicant

POST/v1/score/{slug}

Score a single applicant against a deployed scorecard model. Send the applicant's feature values as a JSON object and receive a credit score, risk grade, probability of default, and per-feature score contributions.

Authentication: API key with score scope. Pass via Authorization: Bearer sk_test_xxx

Path Parameters

slugstringrequired

The deployment slug (e.g. dep_xK8m). Found in the deployment details or returned when deploying a model.

Body Parameters

{feature_name}number | string | nullrequired

Feature values as key-value pairs. Keys must match the feature names defined in the scorecard spec. Values can be numbers, strings, or null for missing data.

strict_modebooleanoptional

When true, the API will reject requests with missing or unrecognized features instead of using default values. Defaults to false.

Error Responses

401invalid_api_key

The API key is missing, expired, or does not have the score scope.

404deployment_not_found

No active deployment matches the provided slug.

429rate_limited

Too many requests. Check the Retry-After header for when to retry.

Score Applicant

curl -X POST https://api.cali-br.com/v1/score/dep_xK8m \
  -H #a5d6ff">"Authorization: Bearer sk_test_abc123" \
  -H #a5d6ff">"Content-Type: application/json" \
  -d '{
    #a5d6ff">"annual_income": 65000,
    #a5d6ff">"debt_to_income": 0.32,
    #a5d6ff">"months_employed": 48,
    #a5d6ff">"num_delinquencies": 1,
    #a5d6ff">"age_of_oldest_account": 84
  }'

Response200

{
  "score": 682,
  "risk_grade": "B",
  "pd": 0.0423,
  "model_version": "1.2.0",
  "model_name": "retail_unsecured_v3",
  "spec_version": "1.0",
  "deployment_id": "dep_xK8m",
  "contributions": {
    "annual_income": 45,
    "debt_to_income": -12,
    "months_employed": 28,
    "num_delinquencies": -18,
    "age_of_oldest_account": 15
  },
  "request_id": "req_abc123def456",
  "scored_at": "2026-03-26T14: 30: 00Z",
  "warnings": []
}