---
title: "Get all companies"
method: GET
path: "/companies"
tags: ["Companies"]
---

# Get all companies

`GET /companies`

## Query parameters

- `limit` integer
- `offset` integer
- `state` 'VOID' | 'WAITING' | 'STARTED' | 'RUNNING' | 'PROCESSED' | 'FAILED' | 'ABORTED' | 'EXPIRED' | 'DELETED'
- `status` 'rejected' | 'need_review' | 'approved'
- `start_date` string, date
- `end_date` string, date
- `workspace_id` string
- `source_id` string

## Response `200`

A list of companies

- Company[]
  - `aml_suspicions` AMLSuspicion[] — List of AML (Anti-Money Laundering) suspicion entries linked to the company, including their details.
    - `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".
  - `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 company, including their results and messages.
    - `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.
  - `company` CompanyInfo — Represents detailed information about a company or legal entity.
    - `address` string — Full registered address of the company.
    - `closure_date` string, date — Closure date of the company, if applicable.
    - `commercial_name` string — Trade or commercial name of the company.
    - `contact` CompanyContact — Contact information for a company representative.
      - `department` string — Department of the contact person.
      - `email` string, email — Email address of the contact person.
      - `first_name` string — First name of the contact person.
      - `last_name` string — Last name of the contact person.
      - `phone_number` string — Phone number of the contact person.
    - `country` string — Country code where the company is registered.
    - `email` string, email — Contact email address for the company.
    - `employees` integer — Number of employees in the company.
    - `employer_identification_number` string — Employer Identification Number (EIN) or equivalent.
    - `insolvency_exists` boolean — Indicates whether an insolvency procedure exists for the company.
    - `insolvency_ongoing` boolean — Indicates whether an insolvency procedure is ongoing for the company.
    - `legal_form` string — Legal form or structure of the company (e.g., LLC, SARL).
    - `name` string — Legal registered name of the company.
    - `phone_number` string — Contact phone number for the company, including country code.
    - `registration_date` string, date — Date when the company was officially registered.
    - `registration_id` string — Official company registration number or ID.
    - `share_capital` string — Total share capital of the company, including currency.
    - `status` string — Current status of the company (e.g., active, inactive).
    - `tax_identification_number` string — Tax identification number for the company.
    - `type` string — Type of company within the workspace, e.g., main or affiliated.
    - `website_url` string, uri — Official website URL of the company.
  - `documents` GenericDocument[] — All documents submitted or associated with the company, including their metadata and processing status.
    - `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).
  - `members` CompanyMember[] — List of members or actors associated with the company, including personal and ownership information.
    - `address` string — Address of the member, which may include street, city, postal code, and country.
    - `birthday` string, date-time — Birthday (available only if type = person)
    - `birthplace` string — Birthplace (available only if type = person)
    - `country` string — ISO 3166-1 alpha-2 country code of the member's address (e.g., "FR" for France).
    - `documents` GenericDocument[] — List of documents associated with the member, including their metadata and processing status.
      - `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).
    - `email` string, email — Email address of the member, which may be used for communication or verification purposes.
    - `first_name` string — First name (available only if type = person)
    - `id` string, uuid
    - `is_beneficial_owner` boolean — Indicates whether the member is a beneficial owner of the company, meaning they have significant control or ownership.
    - `is_delegator` boolean — Indicates whether the member is a delegator, meaning they have authority to act on behalf of the company.
    - `last_name` string — Last name (available only if type = person)
    - `liveness_verification` boolean — Indicates whether liveness verification was performed for the member, typically in the context of identity checks.
    - `name` string — Company name (available only if type = company)
    - `ownership_percentage` integer — Percentage of ownership the member has in the company, expressed as an integer between 0 and 100.
    - `phone_number` string — Contact phone number of the member, including country code and area code.
    - `postal_code` string — Postal code of the member's address, typically a numeric or alphanumeric code.
    - `registration_id` string — Official registration identifier of the member, such as a national ID or company registration number.
    - `relation` string — Type of relationship the member has with the company, such as "shareholder", "director", or "beneficial_owner".
    - `roles` string — Role of the member within the company, such as "legal_representative", "director", or "manager".
    - `source` 'gouve' | 'user' | 'company' — Source of the data (e.g., government, user, company)
    - `state` string — Current state of the member in the workflow, such as "WAITING", "STARTED", "RUNNING", or "PROCESSED".
    - `status` string — Status of the member in the system, indicating whether they are approved, pending, or rejected. Possible values include "approved", "need_review", "rejected".
    - `type` 'person' | 'company' — Member type (person or company)
    - `workspace_id` string — Identifier of the workspace to which the member belongs, used for organizational purposes.
  - `portal_url` string — Admin or internal portal URL for viewing the company's details, typically used by internal users.
  - `properties` Property[] — Custom key-value metadata fields associated with the company, allowing for flexible data storage.
    - `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 company record, useful for tracking or integration purposes.
  - `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 — Public-facing webview URL for the company’s identification process, allowing external access to the company data.

## Changes

- **2025-09-10** `ef18ab7df00d` — 1 info
  - added the optional property `items/technical_data/filtering_score_aml_suspicions` to the response with the `200` status

[Change history](https://skmtc.dev/dataleonlabs/apis/dataleon-api-reference-2/changes/companies/get.md)

---

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