---
title: "Get an individual by ID"
method: GET
path: "/individuals/{individual_id}"
tags: ["Individuals"]
---

# Get an individual by ID

`GET /individuals/{individual_id}`

## Path parameters

- `individual_id` string, required

## Query parameters

- `scope` string
- `document` boolean

## Response `200`

Individual details

- Individual — Represents a single individual record, including identification, status, and associated metadata.
  - `aml_suspicions` AMLSuspicion[] — List of AML (Anti-Money Laundering) suspicion entries linked to the individual.
    - `caption` string — Human-readable description or title for the suspicious finding.
    - `country` string — Country associated with the suspicion (ISO 3166-1 alpha-2 code).
    - `gender` string — Gender associated with the suspicion, if applicable.
    - `relation` string — Nature of the relationship between the entity and the suspicious activity (e.g., "linked", "associated").
    - `schema` string — Version of the evaluation schema or rule engine used.
    - `score` number, float — Risk score between 0.0 and 1 indicating the severity of the suspicion.
    - `source` string — Source system or service providing this suspicion.
    - `status` 'true_positive' | 'false_positive' | 'pending' — Status of the suspicion review process. Possible values: "true_positive", "false_positive", "pending".
    - `type` 'crime' | 'sanction' | 'pep' | 'adverse_news' | 'other' — Category of the suspicion. Possible values: "crime", "sanction", "pep", "adverse_news", "other".
  - `auth_url` string, uri — URL to authenticate the individual, usually for document signing or onboarding.
  - `certificat` Certificat — Represents a certificate file associated with an individual or company.
    - `created_at` string, date-time — Timestamp when the certificate was created.
    - `filename` string — Name of the certificate file.
    - `id` string — Unique identifier for the certificate.
  - `checks` Check[] — List of verification or validation checks applied to the individual.
    - `masked` boolean — Indicates whether the result or data is masked/hidden.
    - `message` string — Additional message or explanation about the check result.
    - `name` string — Name or type of the check performed.
    - `validate` boolean — Result of the check, true if passed.
    - `weight` integer — Importance or weight of the check, often used in scoring.
  - `created_at` string, date-time — Timestamp of the individual's creation in ISO 8601 format.
  - `documents` GenericDocument[] — All documents submitted or associated with the individual.
    - `checks` Check[] — List of verification checks performed on the document.
      - `masked` boolean — Indicates whether the result or data is masked/hidden.
      - `message` string — Additional message or explanation about the check result.
      - `name` string — Name or type of the check performed.
      - `validate` boolean — Result of the check, true if passed.
      - `weight` integer — Importance or weight of the check, often used in scoring.
    - `created_at` string, date-time — Timestamp when the document was created or uploaded.
    - `document_type` string — Type/category of the document.
    - `id` string — Unique identifier of the document.
    - `name` string — Name or label for the document.
    - `signed_url` string, uri — Signed URL for accessing the document file.
    - `state` string — Current processing state of the document (e.g., WAITING, PROCESSED).
    - `status` string — Status of the document reception or approval.
    - `tables` object[] — List of tables extracted from the document, each containing operations.
      - `operation` object[] — List of operations or actions associated with the table.
    - `values` object[] — Extracted key-value pairs from the document, including confidence scores.
      - `confidence` number — Confidence score (between 0 and 1) for the extracted value.
      - `name` string — Name or label of the extracted field.
      - `value` integer[] — List of integer values related to the field (e.g., bounding box coordinates).
  - `id` string, uuid — Unique identifier of the individual.
  - `identity_card` IndiviDualDocument — Represents an individual identity document with personal and document-specific details.
    - `back_document_signed_url` string, uri — Signed URL linking to the back image of the document.
    - `birth_place` string — Place of birth as indicated on the document.
    - `birthday` string — Date of birth in DD/MM/YYYY format as shown on the document.
    - `country` string — Country code issuing the document (ISO 3166-1 alpha-2).
    - `expiration_date` string — Expiration date of the document, in YYYY-MM-DD format.
    - `first_name` string — First name as shown on the document.
    - `front_document_signed_url` string, uri — Signed URL linking to the front image of the document.
    - `gender` string — Gender indicated on the document (e.g., "M" or "F").
    - `id` string — Unique identifier for the document.
    - `issue_date` string — Date when the document was issued, in YYYY-MM-DD format.
    - `last_name` string — Last name as shown on the document.
    - `mrz_line_1` string — First line of the Machine Readable Zone (MRZ) on the document.
    - `mrz_line_2` string — Second line of the MRZ on the document.
    - `mrz_line_3` string, nullable — Third line of the MRZ if applicable; otherwise null.
    - `type` string — Type of document (e.g., passport, identity card).
  - `number` integer — Internal sequential number or reference for the individual.
  - `person` Person — Represents personal information about an individual.
    - `birthday` string — Date of birth, formatted as DD/MM/YYYY.
    - `email` string, email — Email address of the individual.
    - `face_image_signed_url` string, uri — Signed URL linking to the person’s face image.
    - `first_name` string — First (given) name of the person.
    - `full_name` string — Full name of the person, typically concatenation of first and last names.
    - `gender` string — Gender of the individual (e.g., "M" for male, "F" for female).
    - `last_name` string — Last (family) name of the person.
    - `maiden_name` string — Maiden name of the person, if applicable.
    - `nationality` string — Nationality of the individual (ISO 3166-1 alpha-3 country code).
    - `phone_number` string — Contact phone number including country code.
  - `portal_url` string, uri — Admin or internal portal URL for viewing the individual's details.
  - `properties` Property[] — Custom key-value metadata fields associated with the individual.
    - `name` string — Name/key of the property.
    - `type` string — Data type of the property value.
    - `value` string — Value associated with the property name.
  - `risk` Risk — Represents a risk assessment result, including a risk code, explanation, and a confidence score.
    - `code` string — Risk category or code identifier.
    - `reason` string — Explanation or justification for the assigned risk.
    - `score` number, float — Numeric risk score between 0.0 and 1.0 indicating severity or confidence.
  - `source_id` string — Optional identifier indicating the source of the individual record.
  - `state` string — Current operational state in the workflow (e.g., WAITING, IN_PROGRESS, COMPLETED).
  - `status` string — Overall processing status of the individual (e.g., rejected, need_review, approved).
  - `tags` Tag[] — List of tags assigned to the individual for categorization or metadata purposes.
    - `key` string — Name of the tag used to identify the metadata field.
    - `private` boolean — Indicates whether the tag is private (not visible to external users).
    - `type` string — Data type of the tag value (e.g., "string", "number", "boolean").
    - `value` string — Value assigned to the tag.
  - `technical_data` TechnicalData — Contains technical metadata related to processing and communication of an entity.
    - `active_aml_suspicions` boolean — Flag indicating whether there are active research AML (Anti-Money Laundering) suspicions for the object when you apply for a new entry or get an existing one.
    - `api_version` integer — Version number of the API used.
    - `approved_at` string, date-time — Timestamp when the request or process was approved.
    - `callback_url` string, uri — URL to receive callback data from the AML system.
    - `callback_url_notification` string, uri — URL to receive notification updates about the processing status.
    - `disable_notification` boolean — Flag to indicate if notifications are disabled.
    - `disable_notification_date` string, date-time, nullable — Timestamp when notifications were disabled; null if never disabled.
    - `export_type` string — Export format defined by the API (e.g., "json", "xml").
    - `filtering_score_aml_suspicions` number, float — Minimum filtering score (between 0 and 1) for AML suspicions to be considered.
    - `finished_at` string, date-time — Timestamp when the process finished.
    - `ip` string — IP address of the our system handling the request.
    - `language` string — Language preference used in the client workspace (e.g., "fra").
    - `location_ip` string — IP address of the end client (final user) captured.
    - `need_review_at` string, date-time, nullable — Timestamp indicating when the request or process needs review; null if none.
    - `notification_confirmation` boolean — Flag indicating if notification confirmation is required or received.
    - `qr_code` string — Indicates whether QR code is enabled ("true" or "false").
    - `raw_data` boolean — Flag indicating whether to include raw data in the response.
    - `rejected_at` string, date-time, nullable — Timestamp when the request or process was rejected; null if not rejected.
    - `session_duration` integer — Duration of the user session in seconds.
    - `started_at` string, date-time — Timestamp when the process started.
    - `transfer_at` string, date-time — Date/time of data transfer.
    - `transfer_mode` string — Mode of data transfer.
  - `webview_url` string, uri — Public-facing webview URL for the individual’s identification process.
  - `workspace_id` string — Identifier of the workspace to which the individual belongs.

---

[API](https://skmtc.net/dataleonlabs/apis/dataleon-api-reference-2.md) · [All operations](https://skmtc.net/dataleonlabs/apis/dataleon-api-reference-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dataleonlabs/dataleon-api-reference-2/versions/d8b681fb86ae/schema)
