---
title: "candidate.listFraudChecks"
method: POST
path: "/candidate.listFraudChecks"
tags: ["Candidate"]
---

# candidate.listFraudChecks

`POST /candidate.listFraudChecks`

Lists the fraud checks performed on a candidate.

**Requires the [`candidatesRead`](authentication#permissions-candidatelistfraudchecks) permission.**

## Request body

- CandidateListFraudChecksRequest
  - `candidateId` string, uuid, required — The id of the candidate to fetch fraud checks for
  - `cursor` string, nullable — Opaque cursor indicating which page of results to fetch
  - `limit` number, nullable — The maximum number of items to return. The maximum and default value is 100.

## Response `200`

Responses from the candidate.listFraudChecks endpoint

- union
  - CandidateListFraudChecksSuccessResponse
    - `success` true, required
    - `results` FraudCheck[], required
      - `id` string, uuid, required — The unique identifier of this fraud check
      - `candidateId` string, uuid, required — The id of the candidate this fraud check belongs to
      - `applicationId` string, uuid, nullable, required — The id of the application this fraud check is associated with, if any
      - `createdAt` string, required — When this fraud check was performed
      - `fraudSignals` FraudSignal[], required — The fraud signals detected during this fraud check
        - `id` string, uuid, required — The unique identifier of this fraud signal instance
        - `category` string, required — The category of the fraud signal. Possible values include "Social", "Automation", "Geographic", and "Spoofing". Note: this field is unstable and may change over time.
        - `name` string, required — A human-readable name for this fraud signal. Note: this field is unstable and may change over time.
        - `description` string, required — A description of what this fraud signal means. Note: this field is unstable and may change over time.
        - `value` string, nullable — An optional value associated with this signal, providing additional context (e.g., location information, account counts). Only present when a value exists for the signal. Note: this field is unstable and may change over time.
    - `nextCursor` string — Cursor for the next page of results, if available
    - `moreDataAvailable` boolean — Whether more data is available beyond this page
    - `syncToken` string — Sync token to use for future incremental syncs. Only present on the last page.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)