---
title: "Create a Fraud database check"
method: POST
path: "/v1/checks/fraud-database"
tags: ["Fraud database check"]
---

# Create a Fraud database check

`POST /v1/checks/fraud-database`

Create a Fraud database check. The check will search for fraud records associated with the individual or company.  
This feature needs to be enabled on your workspace first. Contact your Customer Success Manager or support@dotfile.com for more information.

## Request body

- FraudDatabaseCheckCreate
  - `individual_id` string, uuid, required
  - `settings` FraudDatabaseCheckSettingsCreate
    - `vendor` 'cifas' — Vendor to use for fraud database check. Currently only `cifas` is supported.
    - `automatic_approval` boolean
    - `automatic_rejection` boolean
  - `company_id` string, uuid, required

## Response `201`

Fraud database check has been created

**ℹ️ Click to see full payload**

- FraudDatabaseCheck
  - `id` string, uuid, required
  - `company_id` string, uuid, nullable, required
  - `individual_id` string, uuid, nullable, required
  - `is_internal` boolean, required
  - `status` 'in_progress' | 'need_review' | 'processing' | 'approved' | 'rejected' | 'expired', required — ℹ️ Check status `expired` is deprecated and will be removed Q1'25. It will be replaced with an expired flag.
  - `type` 'fraud_database', required
  - `subtype` string, nullable, required — Currently always null for `fraud_database` Check
  - `last_activity_at` string, date-time, required — Latest activity date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `data` FraudDatabaseCheckData, required
    - `result` 'approved' | 'rejected' | 'error', nullable, required
    - `settings` FraudDatabaseCheckDataSettings, required
      - `vendor` 'cifas', required
      - `automatic_approval` boolean, required
      - `automatic_rejection` boolean, required
    - `vendor` FraudDatabaseCheckDataVendor, required
      - `name` 'cifas', required
      - `search_reference` string, nullable, required
    - `review` Review, required
      - `comment` string, nullable, required
      - `reviewed_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
      - `reviewer_type` 'user' | 'system' | 'api', nullable, required
      - `user` NestedUser, required
        - `id` string, uuid, required
        - `first_name` string, required
        - `last_name` string, required
        - `email` string, email, required
    - `information` FraudDatabaseCheckDataInformation, required
      - `entity_type` 'company' | 'individual', required
      - `first_name` string, nullable, required
      - `last_name` string, nullable, required
      - `birth_date` string, nullable, required
      - `email` string, nullable, required
      - `phone_number` string, nullable, required
      - `company_name` string, nullable, required
      - `company_number` string, nullable, required
      - `vat_number` string, nullable, required
      - `address` Address, required
        - `street_address` string, nullable, required
        - `street_address_2` string, nullable, required
        - `postal_code` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `region` string, nullable, required
        - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `ai_analysis` FraudDatabaseCheckDataAiAnalysis, required
      - `interpretation` string, nullable, required

## Other responses

- `400` — The request is either malformed or contain invalid parameters. - Make sure the body payload matches the expected schema - Limit reached. Contact us at support@dotfile.com to lift all limits. - When the feature is disabled for the workspace

---

[API](https://skmtc.dev/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.dev/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotfile/api-specifications/revisions/36393567057b/schema)