list_scoring_models

GET /v1/scoring_models lists your organization's scoring models, with what each predicts and when it was last calibrated.

Use it to find a scoring model's model_id, or to check whether one you need already exists. For one scoring model's questions, use get_scoring_model.

GET

/v1/scoring_models

Lists your organization's scoring models, newest first (up to 500), with each one's name, criteria and when it was last calibrated. Use it to find a scoring model's model_id.

Responses

The organization's scoring models.

Field	Type	Description
`scoring_models`	array of object	Your scoring models, newest first.

Field	Type	Description
`model_id`	string	The scoring model's id, `scm_…`.
`name`	string	A few words saying what it predicts: the `name` it was created with, or the one it was given in the Finic Portal. Empty for scoring models created before names, until someone names it there.
`status`	`training`, `ready`, `failed`	`training` while it's being created, `ready` to score records, `failed` if creating it failed (create it again).
`criteria`	string	The `criteria` it was created with. Empty if none was given.
`created_at`	string	When the scoring model was created.
`calibrated_at`	string or null	When it was last calibrated, or `null` if it isn't calibrated. One created from examples is calibrated from the start; one created from its criteria alone scores with Finic's estimated weights until you calibrate it.
`archived_at`	string or null	When it was archived in the Finic Portal, or `null`. Calls to score with or calibrate an archived scoring model fail with `scoring_model_archived` until it's unarchived.
`examples`	integer	The number of examples it was created from, or first calibrated with; 0 until then.
`bad_rate`	number	The share of those examples with `is_bad` true, 0 to 1; 0 until then.
`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`	`authentication_error`: the API key is missing, unknown, revoked or expired.
`429`	`rate_limited`: over the organization's request rate. Retry with backoff.

Every error has the same shape; see Errors.

Examples

Example Request

curl -X GET 'https://api.finic.ai/v1/scoring_models' \  -H "Authorization: Bearer $FINIC_API_KEY"

Example ResponseSchema

{  "scoring_models": [    {      "model_id": "scm_01M4XRC000RT2GZSKYPD8J86G9",      "name": "Card-not-present payment fraud",      "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",      "archived_at": null,      "examples": 1800,      "bad_rate": 0.062,      "scored": 41250,      "outcomes": 3900    }  ]}

Responses

200 OK

Each scoring model: scoring_models[]

Errors (401, 429)

Examples