add_questions
POST /v1/scoring_models/{model_id}/questions adds your own yes/no questions to a scoring model, without calibrating it.
Before a scoring model is calibrated, the questions you add count right away; after, they're tried at the next calibration. See Changing questions. Free.
Adds your own yes/no questions about a record to a scoring model, without calibrating it.
- If it isn't calibrated yet, the score uses them right away, each with a weight Finic estimates.
- If it's calibrated, they're asked on every score call and tried at the next calibration, which uses them if they help: with examples, or with outcomes once 30 of the records they were asked about have one. Until then they're listed as not used on its page in the Finic Portal.
Up to 20 at a time, 50 of yours per scoring model (used or not), 500 characters each. See Changing questions.
Path parameters
| Field | Type | Description |
|---|---|---|
model_idrequired | string | The scoring model's |
Request body
application/json
| Field | Type | Description |
|---|---|---|
questionsrequired | array of string | Your own yes/no questions about a record, such as "Was the account opened less than a week before the payment?". |
Responses
The scoring model, as get_scoring_model returns it, with added.
| Status | Type and when |
|---|---|
400 |
|
401 |
|
404 |
|
409 |
|
429 |
|
503 |
|
Every error has the same shape; see Errors.
Examples
curl -X POST 'https://api.finic.ai/v1/scoring_models/string/questions' \ -H "Authorization: Bearer $FINIC_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "questions": [ "Was the account opened less than a week before the payment?" ]}'{ "model_id": "scm_01M4XRC000RT2GZSKYPD8J86G9", "name": "Card-not-present payment fraud", "status": "ready", "criteria": "Card-not-present payments at an online store. Bad: the payment was charged back as fraud within 90 days.", "created_at": "2026-10-20T17:04:11Z", "calibrated_at": null, "archived_at": null, "examples": 0, "bad_rate": 0, "scored": 12, "outcomes": 0, "questions": [ { "id": "q003", "text": "This record is a card payment. Is the IP address in a different country from the billing address?", "source": "finic", "weight": 1.24 }, { "id": "q009", "text": "Was the account opened less than a week before the payment?", "source": "user", "weight": 0.93 }, { "id": "q006", "text": "This record is a card payment. Has this card paid this merchant before without a dispute?", "source": "finic", "weight": -0.71 } ], "added": [ { "id": "q009", "text": "Was the account opened less than a week before the payment?", "used": true } ]}