list_scores
GET /v1/scores lists your organization's scores, with what each predicts and when it was last calibrated.
Use it to find a score's model_id, or to check whether a score you need already exists.
Lists your organization's scores, newest first (up to 500), with what each predicts and when it was last calibrated. Use it to find a score's model_id.
Responses
The organization's scores.
| Field | Type | Description |
|---|---|---|
scores | array of object | Your scores, newest first. |
| Field | Type | Description |
|---|---|---|
model_id | string | The score's id, |
status | training, ready, failed |
|
criteria | string | What the score predicts, in words. It's the |
created_at | string | When the score was created. |
calibrated_at | string or null | When it was last calibrated, or |
examples | integer | The number of examples it was created from. |
bad_rate | number | The share of those examples with |
scored | integer | The number of records scored with it. |
outcomes | integer | The number of those records with an outcome sent to calibrate. |
| Status | Type and when |
|---|---|
401 |
|
429 |
|
Every error has the same shape; see Errors.
Examples
curl -X GET 'https://api.finic.ai/v1/scores' \ -H "Authorization: Bearer $FINIC_API_KEY"{ "scores": [ { "model_id": "scm_01M4XRC000RT2GZSKYPD8J86G9", "status": "ready", "criteria": "Card-not-present payments. is_bad: the payment was charged back as fraud within 90 days.", "created_at": "2026-10-20T17:04:11Z", "calibrated_at": "2026-10-24T09:30:52Z", "examples": 1800, "bad_rate": 0.062, "scored": 41250, "outcomes": 3900 } ]}