---
title: "Retrieve a case"
method: GET
path: "/v1/cases/{id}"
tags: ["Cases"]
---

# Retrieve a case

`GET /v1/cases/{id}`

Returns detailed information about the specified case.

---

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

## Path parameters

- `id` string, required

## Query parameters

- `include_not_relevant` boolean
- `exclude_internal_checks` boolean
- `property_origin` boolean

## Response `200`

**ℹ️ Click to see full payload**

- CaseDetailed
  - `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' | '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`)
    - `property_origins` object — Property origin details keyed by property path, returned only when `property_origin=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' | '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`)
    - `property_origins` object — Property origin details keyed by property path, returned only when `property_origin=true` is provided.
  - `assignee` NestedUser, required
    - `id` string, uuid, required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, email, required
  - `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

- `404` — No case can be found.

---

[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)