--- title: "List all individuals" method: GET path: "/v1/individuals" tags: ["Individuals"] --- # List all individuals `GET /v1/individuals` Returns a list of all individuals created in your Dotfile workspace. --- #### See also Learn more about [Filtering, Sorting and Pagination](./filtering-sorting-and-pagination) ## Query parameters - `first_name` string - `last_name` string - `birth_date` string — Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) - `email` string - `created_at` string — Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) - `updated_at` string — Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) - `last_activity_at` string — Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) - `sort` string - `page` number - `limit` number ## Response `200` List of individuals created in the workspace **ℹ️ Click to see full payload** - PaginatedIndividualList - `data` IndividualList[], 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 - `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`) - `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`) - `pagination` Pagination, required - `page` number, required — Current page number (defined in query parameter) - `limit` number, required — Item count per page (defined in query parameter) - `count` number, required — Total items count ## Other responses - `400` — The request is either malformed or contain invalid parameters. - One or multiple filtering parameters might be malformed. Make sure to use a supported operator and value for each filter. - If specified, make sure the value of the `page` or `limit` query parameter are valid. - Value of the `sort` parameter is invalid. Make sure the field name is supported, the sorting order is correctly specified, and a same field is not used multiple times for sorting. --- [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)