get_scoring_model

GET /v1/scoring_models/{model_id} gets one scoring model, with the questions it uses and how much each counts.

Use a question's id to remove it with remove_question, or when you calibrate. See Questions and weights.

GET

/v1/scoring_models/{model_id}

Gets one scoring model, with the fields list_scoring_models gives and the questions it uses, each with its weight at the latest calibration, or Finic's estimate if it isn't calibrated yet. Your own questions it doesn't use are listed on its page in the Finic Portal.

Path parameters

Field	Type	Description
`model_id`required	string	The scoring model's `model_id`.

Responses

The scoring model.

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.
`questions`	array of object	The questions it uses, the strongest first. Your own questions it doesn't use are listed on its page in the Finic Portal.

Field	Type	Description
`id`	string	The question's id, such as `q007`, for remove_question or `remove_questions`.
`text`	string	The question
`source`	`finic`, `user`	`finic` for a question Finic wrote, `user` for one you added.
`weight`	number	How much it moves the score, from the latest calibration, or Finic's estimate if the scoring model isn't calibrated yet. Positive when a likely yes raises the score, negative when it lowers it; the larger, the more it counts.

Status	Type and when
`401`	`authentication_error`: the API key is missing, unknown, revoked or expired.
`404`	`scoring_model_not_found`: no scoring model with this `model_id` in your organization.
`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/string' \  -H "Authorization: Bearer $FINIC_API_KEY"

Example ResponseSchema

{  "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,  "questions": [    {      "id": "q004",      "text": "This record is a card payment. Is the IP address in a different country from the billing address?",      "source": "finic",      "weight": 0.91    },    {      "id": "q017",      "text": "This record is a card payment. Does the account look newly opened for this purchase?",      "source": "finic",      "weight": 0.64    },    {      "id": "q022",      "text": "This record is a card payment. Is this a typical amount for the merchant category?",      "source": "finic",      "weight": -0.52    },    {      "id": "q051",      "text": "Was the account opened less than a week before the payment?",      "source": "user",      "weight": 0.38    }  ]}

Path parameters

Responses

200 OK

Each question: questions[]

Errors (401, 404, 429)

Examples