---
title: "Create a case"
method: POST
path: "/v1/cases"
tags: ["Cases"]
---

# Create a case

`POST /v1/cases`

## Request

- Base URL: `https://api.dotfile.com`
- URL: `https://api.dotfile.com/v1/cases`
- Auth: API key in header `X-DOTFILE-API-KEY`

Create a case in your workspace.

---

#### See also  
Learn more about [Cases](./cases-guide)  
Learn more about [Templates](./templates-guide)

## Request body

- CaseCreate
  - `name` string, required: Name for the case (at most 180 characters).
  - `status` 'draft' | 'open': Optional status for this case, Defaults to `open`. To set the status to `approved`, `rejected` or `closed`, use the [Create a case review](./case-review-create-one) endpoint.
  - `external_id` string: Optional external id for this case. You can use that to reference an entity of your system. Must be unique if set.
  - `template_key` string, nullable: Optional template key to attach template to this case.
  - `template_id` string, uuid, nullable: Prefer using `template_key` instead. Optional template id to attach template to this case. Cannot be set at the same time as `template_key`.
  - `assignee_id` string, uuid, nullable: Optional assignee id to assign a user to this case.
  - `space_slug` string, nullable: Optional space slug to assign this case to a space at creation. Must reference a space in the same workspace. Cases created without `space_slug` remain unassigned.
  - `metadata` object, nullable: Optional metadata in a format of `key` (string) / `value` (string) for this case.
  - `custom_properties` object: Optional partial custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to create the case. Archived custom properties are not accepted.
  - `tags` string[], nullable: Optional tags for this case. Either tag `id`, or tag `label`. Tag labels are case insensitive
  - `companies` CompanyCreateInput[]: Optional array of companies to create within this case. Each company can reference other companies in the same payload using the `ref` field. At least one company with `type: main` is expected if companies are provided.
    - `name` string, required: Name for the company (at most 160 characters).
    - `type` 'main' | 'affiliated'
    - `commercial_name` string, nullable: Commercial name for the company (at most 160 characters).
    - `registration_number` string, nullable
    - `registration_date` string, date, nullable: Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
    - `status` 'live' | 'closed' | 'not_reported'
    - `legal_form` string, nullable
    - `entity_legal_form` string, nullable: [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
    - `country` string, alpha-2, nullable: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `address` PartialAddress
      - `street_address` string, nullable
      - `street_address_2` string, nullable
      - `postal_code` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `region` string, nullable
      - `country` string, alpha-2, nullable: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `classifications` CompanyClassification[]
      - `type` string, required
      - `code` string, required
      - `description` string, nullable
    - `banking_information` BankingInformation
      - `iban` string, nullable, required: [ISO 13616](https://en.wikipedia.org/wiki/International_Bank_Account_Number) IBAN (eg: `FR7630006000011234567890189`). Spaces will be removed and value upper-cased.
      - `bic` string, nullable, required: [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362) BIC (eg: `AGRIFRPPXXX`). Spaces will be removed and value upper-cased.
    - `share_capital` string, nullable
    - `tax_identification_number` string, nullable
    - `website_url` string, nullable
    - `employer_identification_number` string, nullable
    - `custom_properties` object: Optional partial custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to create the company. Archived custom properties are not accepted.
    - `ref` string: Unique reference identifier within this request payload. Use this to reference the company from other entities (e.g., in `source_company_ref` of relations). Can be any unique string (e.g., "main-co", "holding-1").
    - `relations` CaseRelationCreateWithRef[]
      - `voting_rights_percentage` number, float, nullable
      - `ownership_percentage` number, float, nullable
      - `roles` string[]: `legal_representative` `shareholder`
      - `position` string, nullable
      - `source_company_ref` string: Reference to the source company within the same payload. Use the `ref` value of the company this relation comes FROM. When omitted, defaults to the main company of the case.
  - `individuals` IndividualCreateInput[]: Optional array of individuals to create within this case. Individuals can reference companies in the same payload using `source_company_ref` in their relations.
    - `first_name` string, required
    - `middle_name` string, nullable: May contain multiple middle names
    - `last_name` string, required
    - `maiden_name` string, nullable
    - `is_business_contact` boolean: Set to `true` if this individual should be contacted regarding the case, this will also make the `email` required.
    - `is_beneficial_owner` boolean: Set to true if this individual ultimately owns or controls the main company
    - `is_controlling_person` boolean: Set to true if this individual exercises control over the main company through means other than ownership (e.g. senior management, board member)
    - `is_delegator` boolean: Set to true if this individual is delegating its signing authority to the signatory of the case. Individual cannot be both delegator and signatory Not relevant individual cannot be delegator
    - `is_signatory` boolean: Set to true if this person has delegated authority to be a signatory of the case, this will also make the `email` required. Individual cannot be both signatory and delegator Not relevant individual cannot be signatory
    - `email` string, email, nullable: Required if individual `is_business_contact` is `true`. Must be a valid email as defined in the [HTML spec](https://html.spec.whatwg.org/multipage/input.html#valid-e-mail-address) (eg. must match the following JavaScript-compatible regular expression: ```/^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/```)
    - `birth_date` string, date, nullable: Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
    - `birth_country` string, alpha-2, nullable: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `birth_place` string, nullable
    - `gender` 'male' | 'female' | 'other', nullable: Gender of the individual
    - `nationalities` string[], nullable: Nationalities of the individual as ISO 3166-1 alpha-2 country codes
    - `address` PartialAddress
      - `street_address` string, nullable
      - `street_address_2` string, nullable
      - `postal_code` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `region` string, nullable
      - `country` string, alpha-2, nullable: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `banking_information` BankingInformation
      - `iban` string, nullable, required: [ISO 13616](https://en.wikipedia.org/wiki/International_Bank_Account_Number) IBAN (eg: `FR7630006000011234567890189`). Spaces will be removed and value upper-cased.
      - `bic` string, nullable, required: [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362) BIC (eg: `AGRIFRPPXXX`). Spaces will be removed and value upper-cased.
    - `tax_identification_number` string, nullable
    - `social_security_number` string, nullable
    - `phone_number` string, e.164, nullable: [E.164](https://en.wikipedia.org/wiki/E.164) phoneNumber (eg `+XXXXXXXXXXX`)
    - `position` string, nullable
    - `ownership_percentage` number, nullable
    - `voting_rights_percentage` number, nullable
    - `roles` string[]: `legal_representative` `shareholder`
    - `custom_properties` object: Optional partial custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to create the individual. Archived custom properties are not accepted.
    - `ref` string: Unique reference identifier within this request payload. Use this to reference the individual from other entities in the same payload. Can be any unique string (e.g., "john-doe", "ceo-1").
    - `relations` CaseRelationCreateWithRef[]
      - `voting_rights_percentage` number, float, nullable
      - `ownership_percentage` number, float, nullable
      - `roles` string[]: `legal_representative` `shareholder`
      - `position` string, nullable
      - `source_company_ref` string: Reference to the source company within the same payload. Use the `ref` value of the company this relation comes FROM. When omitted, defaults to the main company of the case.

## Response `201`

Case has been created in the workspace

**ℹ️ Click to see full payload**

- CaseCreateResponse
  - `id` string, uuid, required
  - `name` string, required
  - `status` 'draft' | 'open' | 'approved' | 'rejected' | 'closed', required
  - `review` CaseReview, required
    - `id` string, uuid, required
    - `status` 'approved' | 'rejected' | 'closed', required
    - `comment` string, nullable, required
    - `reviewer_type` 'user' | 'system' | 'api', required
    - `user` NestedUser, required
      - `id` string, uuid, required
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email, required
    - `reviewed_at` string, date-time, 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`)
    - `next_review_at` string, date, nullable, required: Next review date. `null` if no review schedule after this one. Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
  - `external_id` string, nullable, required
  - `space_slug` string, nullable, required
  - `template` TemplateLight, required
    - `id` string, uuid, required
    - `name` string, required
    - `key` string, required
  - `template_id` string, uuid, nullable, required: Prefer using `template.key` instead.
  - `contact_has_actions` boolean, required
  - `reviewer_has_actions` boolean, required
  - `flags` string[], required: `all_checks_approved` `for_review` `for_first_collect` `for_recollection` `first_collect_completed`
  - `tags` string[], required
  - `risk` Risk, required
    - `id` string, required
    - `mode` 'automatic' | 'manual', required
    - `level` 'not_defined' | 'low' | 'medium' | 'high' | 'critical' | 'prohibited', required
    - `comment` string, nullable, required
    - `score` number, nullable, required
    - `components` object, nullable, required: Object in a format of `key` (string) / `value` (number)
    - `flags` object, nullable, required: Object in a format of `key` (string) / `value` (boolean)
    - `created_at` string, date-time, required: Creation 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`)
    - `updated_at` string, date-time, required: Latest update 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`)
  - `custom_properties` object, required: Custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to read the case. Archived custom properties are omitted.
  - `metadata` object, nullable, required: Object in a format of `key` (string) / `value` (string)
  - `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`)
  - `last_contact_action_at` string, date-time, nullable, required: Latest contact action 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`)
  - `controls` CaseControl[], required
    - `id` string, uuid, required
    - `is_completed` boolean, 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
    - `control` Control, required
      - `id` string, uuid, required
      - `label` string, required
      - `key` string, required
      - `type` 'manual' | 'automatic_logic' | 'automatic_code', required
      - `archived_at` string, date-time, nullable, required: Archive 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`)
    - `created_at` string, date-time, required: Creation 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`)
    - `updated_at` string, date-time, required: Latest update 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`)
  - `individuals` Individual[], required
    - `id` string, uuid, required
    - `case_id` string, uuid, required
    - `roles` string[], required: `legal_representative` `shareholder`
    - `is_beneficial_owner` boolean, required: Set to true if this individual ultimately owns or controls the main company
    - `is_controlling_person` boolean, required: Set to true if this individual exercises control over the main company through means other than ownership (e.g. senior management, board member)
    - `is_business_contact` boolean, required: Set to true if this individual should be contacted regarding the case
    - `is_delegator` boolean, required: Set to true if this individual is delegating its signing authority to the signatory of the case
    - `is_signatory` boolean, required: Set to true if this person has delegated authority to be a signatory of the case
    - `is_relevant` boolean, required
    - `first_name` string, required
    - `middle_name` string, nullable, required: May contain multiple middle names
    - `last_name` string, required
    - `maiden_name` string, nullable, required
    - `email` string, email, nullable, required
    - `birth_date` string, date, nullable, required: Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
    - `birth_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`)
    - `birth_place` string, nullable, required
    - `gender` 'male' | 'female' | 'other', nullable, required: Gender of the individual
    - `nationalities` string[], nullable, required: Nationalities of the individual as ISO 3166-1 alpha-2 country codes
    - `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`)
    - `banking_information` BankingInformation, required
      - `iban` string, nullable, required: [ISO 13616](https://en.wikipedia.org/wiki/International_Bank_Account_Number) IBAN (eg: `FR7630006000011234567890189`). Spaces will be removed and value upper-cased.
      - `bic` string, nullable, required: [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362) BIC (eg: `AGRIFRPPXXX`). Spaces will be removed and value upper-cased.
    - `tax_identification_number` string, nullable, required
    - `social_security_number` string, nullable, required
    - `phone_number` string, e.164, nullable, required: Phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format (eg `+33123456789`) [E.164](https://en.wikipedia.org/wiki/E.164) phoneNumber (eg `+XXXXXXXXXXX`)
    - `position` string, nullable, required
    - `ownership_percentage` number, float, nullable, required
    - `voting_rights_percentage` number, float, nullable, required
    - `custom_properties` object, required: Custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to read the individual. Archived custom properties are omitted.
    - `checks` Check[], required
      - `id` string, uuid, required
      - `individual_id` string, nullable, required
      - `company_id` string, 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` 'id_verification' | 'id_document' | 'aml' | 'company_monitoring' | 'document' | 'ekyc' | 'electronic_signature' | 'email_phone_verification' | 'fraud_database' | 'online_reputation', required
      - `subtype` string, nullable, required: Contains the `subtype` for some check `type`: - `document`: Currently contains `"document_type:{document_type_key}"` - `electronic_signature`: Contains `"document_template:{document_template_key}"` - For all other check type, always contains `null`
      - `document_type_key` string: Set only for `document` Check with the document type key.
      - `created_at` string, date-time, required: Creation 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`)
      - `updated_at` string, date-time, required: Latest update 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`)
      - `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`)
    - `relations` CaseRelationOfEntity[], required
      - `id` string, uuid, required
      - `to_company_id` string, uuid, required
      - `voting_rights_percentage` number, float, nullable, required
      - `ownership_percentage` number, float, nullable, required
      - `roles` string[], required: `legal_representative` `shareholder`
      - `position` string, nullable, required
      - `created_at` string, date-time, required: Creation 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`)
      - `updated_at` string, date-time, required: Latest update 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`)
    - `created_at` string, date-time, required: Creation 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`)
    - `updated_at` string, date-time, required: Latest update 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`)
    - `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_lineage` object: Data lineage keyed by property path, returned only when `data_lineage=true` is provided.
  - `companies` Company[], required
    - `id` string, uuid, required
    - `case_id` string, uuid, required
    - `type` 'main' | 'affiliated', required
    - `name` string, required
    - `is_relevant` boolean, required
    - `commercial_name` 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`)
    - `registration_number` string, nullable, required
    - `registration_date` string, date, nullable, required: Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
    - `status` 'live' | 'closed' | 'not_reported', required
    - `legal_form` string, nullable, required
    - `entity_legal_form` string, nullable, required: [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
    - `entity_legal_form_label` string, nullable, required: Label in the origin country language of the [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code. May contains multiple labels separated with a comma `,` when the code is assigned to multiple label in different languages.
    - `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`)
    - `classifications` CompanyClassification[], nullable, required
      - `type` string, required
      - `code` string, required
      - `description` string, nullable
    - `banking_information` BankingInformation, required
      - `iban` string, nullable, required: [ISO 13616](https://en.wikipedia.org/wiki/International_Bank_Account_Number) IBAN (eg: `FR7630006000011234567890189`). Spaces will be removed and value upper-cased.
      - `bic` string, nullable, required: [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362) BIC (eg: `AGRIFRPPXXX`). Spaces will be removed and value upper-cased.
    - `share_capital` string, nullable, required
    - `tax_identification_number` string, nullable, required
    - `website_url` string, nullable, required
    - `employer_identification_number` string, nullable, required
    - `custom_properties` object, required: Custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to read the company. Archived custom properties are omitted.
    - `document_orders` DocumentOrder[], required
      - `id` string, uuid, required
      - `company_id` string, uuid, required
      - `product_ref` string, required
      - `name` string, required
      - `price_tier` string, required
      - `status` 'created' | 'processing' | 'completed' | 'failed', required
      - `file_id` string, nullable, required
      - `created_at` string, date-time, required: Creation 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`)
      - `updated_at` string, date-time, required: Latest update 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`)
    - `checks` Check[], required
      - `id` string, uuid, required
      - `individual_id` string, nullable, required
      - `company_id` string, 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` 'id_verification' | 'id_document' | 'aml' | 'company_monitoring' | 'document' | 'ekyc' | 'electronic_signature' | 'email_phone_verification' | 'fraud_database' | 'online_reputation', required
      - `subtype` string, nullable, required: Contains the `subtype` for some check `type`: - `document`: Currently contains `"document_type:{document_type_key}"` - `electronic_signature`: Contains `"document_template:{document_template_key}"` - For all other check type, always contains `null`
      - `document_type_key` string: Set only for `document` Check with the document type key.
      - `created_at` string, date-time, required: Creation 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`)
      - `updated_at` string, date-time, required: Latest update 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`)
      - `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`)
    - `relations` CaseRelationOfEntity[], required
      - `id` string, uuid, required
      - `to_company_id` string, uuid, required
      - `voting_rights_percentage` number, float, nullable, required
      - `ownership_percentage` number, float, nullable, required
      - `roles` string[], required: `legal_representative` `shareholder`
      - `position` string, nullable, required
      - `created_at` string, date-time, required: Creation 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`)
      - `updated_at` string, date-time, required: Latest update 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`)
    - `created_at` string, date-time, required: Creation 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`)
    - `updated_at` string, date-time, required: Latest update 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`)
    - `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_lineage` object: Data lineage keyed by property path, returned only when `data_lineage=true` is provided.
  - `assignee` NestedUser, required
    - `id` string, uuid, required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, email, required
  - `assignee_id` string, nullable, required: The user id of the assignee of the case. `null` if not assigned. Prefer to use `assignee.id` instead.
  - `client_portal` CaseClientPortal, required
    - `id` string, uuid, required
    - `name` string, required
    - `type` 'KYB' | 'KYC', required
    - `wait_step_key` string, nullable, required: Set when a contact reaches and triggers a `wait` step of this client portal, which will also emit a `ClientPortal.ClientPortalWaitStepTriggered` webhook event. You then need to release the `wait` step using [Complete client portal wait step](./client-portal-complete-client-portal-wait-step) to allow the contact to continue the client portal forms
  - `created_at` string, date-time, required: Creation 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`)
  - `updated_at` string, date-time, required: Latest update 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`)

## Other responses

- `400`: The request is either malformed or contain invalid parameters. - Make sure the body payload matches the expected schema

## Changes

- **2026-11-03** `50cab516e856`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dotfile/apis/api-specifications/changes/v1/cases/post.md)

---

[API](https://skmtc.dev/dotfile/apis/api-specifications.md) - [All operations](https://skmtc.dev/dotfile/apis/api-specifications/llms.txt) - [OpenAPI document](https://skmtc.dev/dotfile/apis/api-specifications/revisions/50cab516e856?raw)