Record Recheck

post/v1/applicants/{applicant_id}/checks/recheck

Record a re-run of a check on this applicant. Two cases: - ``flow_id`` set, flow non-terminal → group the new check under it AND re-evaluate the flow's decision via the rules engine. - Otherwise → the check lands on the applicant's timeline only; no flow is affected. Operators use ``/v1/flows/{id}/decide`` if they want to update an existing flow's decision separately.

Authentication

Send your tenant secret key as a Bearer token. Keep secret keys on your server; never ship them in browser or mobile code.

Parameters

applicant_id

path · required

No additional parameter description.

Request body

JSON · required

check_type

CheckTyperequired

No additional field description.

flow_id

string | null

No additional field description.

output

object

No additional field description.

reason_codes

string[]

No additional field description.

result

CheckResultrequired

No additional field description.

Example request

cURL

curl --request POST \
  --url 'https://api.fideralabs.com/v1/applicants/{applicant_id}/checks/recheck' \
  --header 'Authorization: Bearer $FIDERA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "check_type": "string",
  "flow_id": "00000000-0000-0000-0000-000000000000",
  "output": {},
  "reason_codes": [
    "string"
  ],
  "result": "string"
}'

Responses

201Successful Response

alert_count

integer

No additional field description.

applicant_id

string | null

No additional field description.

applicant_name

string | null

No additional field description.

check_type

CheckTyperequired

No additional field description.

completed_at

string | null

No additional field description.

created_at

stringrequired

No additional field description.

dataset_versions

object[]

No additional field description.

datasets

string[] | null

No additional field description.

decision

CheckDecision | null

No additional field description.

error

string | nullrequired

No additional field description.

evidence

object

No additional field description.

flow_id

string | null

No additional field description.

id

stringrequired

No additional field description.

input_ref

string | null

No additional field description.

latency_ms

integer | null

No additional field description.

mode

CheckMode

No additional field description.

normalized_query

object

No additional field description.

output

objectrequired

No additional field description.

policy_snapshot

object

No additional field description.

policy_version

string | null

No additional field description.

reason_codes

string[]required

No additional field description.

result

CheckResultrequired

No additional field description.

source_versions

object[]

No additional field description.

status

CheckStatusrequired

No additional field description.

submission_id

string | null

No additional field description.

use_case

CheckUseCase

No additional field description.

application/json

{
  "alert_count": 0,
  "applicant_id": "00000000-0000-0000-0000-000000000000",
  "applicant_name": "string",
  "check_type": "string",
  "completed_at": "2026-07-29T12:00:00Z",
  "created_at": "2026-07-29T12:00:00Z",
  "dataset_versions": [
    {}
  ],
  "datasets": [
    "string"
  ],
  "decision": "string",
  "error": "string",
  "evidence": {},
  "flow_id": "00000000-0000-0000-0000-000000000000"
}

422Validation Error

detail

ValidationError[]

No additional field description.

Operation ID

record_recheck_v1_applicants__applicant_id__checks_recheck_post