---
title: "Create a new company"
method: POST
path: "/companies"
tags: ["Companies"]
---

# Create a new company

`POST /companies`

## Request body

- object
  - `company` object, required — Main information about the company being registered.
    - `address` string — Registered address of the company.
    - `commercial_name` string — Commercial or trade name of the company, if different from the legal name.
    - `country` string — ISO 3166-1 alpha-2 country code of company registration (e.g., "FR" for France).
    - `email` string, email — Contact email address for the company.
    - `employer_identification_number` string — Employer Identification Number (EIN) or equivalent.
    - `legal_form` string — Legal structure of the company (e.g., SARL, SAS).
    - `name` string, required — Legal name of the company.
    - `phone_number` string, string — Contact phone number for the company.
    - `registration_date` string — Date of official company registration in YYYY-MM-DD format.
    - `registration_id` string — Official company registration identifier.
    - `share_capital` string — Declared share capital of the company, usually in euros.
    - `status` string — Current status of the company (e.g., active, inactive).
    - `tax_identification_number` string — National tax identifier (e.g., VAT or TIN).
    - `type` string — Type of company, such as "main" or "affiliated".
    - `website_url` string — Company’s official website URL.
  - `source_id` string — Optional identifier to track the origin of the request or integration from your system.
  - `technical_data` object — Technical metadata and callback configuration.
    - `active_aml_suspicions` boolean — Flag indicating whether there are active research AML (Anti-Money Laundering) suspicions for the company when you apply for a new entry or get an existing one.
    - `callback_url` string, uri — URL to receive a callback once the company is processed.
    - `callback_url_notification` string, uri — URL to receive notifications about the processing state and status.
    - `filtering_score_aml_suspicions` number, float — Minimum filtering score (between 0 and 1) for AML suspicions to be considered.
    - `language` string — Preferred language for responses or notifications (e.g., "eng", "fra").
    - `portal_steps` string[] — List of steps to include in the portal workflow.
    - `raw_data` boolean — Flag indicating whether to include raw data in the response.
  - `workspace_id` string, required — Unique identifier of the workspace in which the company is being created.

## Response `201`

Company created successfully

- 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.
    - `approved_by` string, nullable — Identifier of the actor who approved (e.g., user id or username).
    - `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.
    - `need_review_by` string, nullable — Identifier of the actor who requested review (e.g., user id or username).
    - `notification_confirmation` boolean — Flag indicating if notification confirmation is required or received.
    - `portal_steps` string[] — List of steps to include in the portal workflow.
    - `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.
    - `rejected_by` string, nullable — Identifier of the actor who rejected (e.g., user id or username).
    - `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

- **2026-01-20** `0c006dfe7a69` — 3 info
  - added the optional property `technical_data/approved_by` to the response with the `201` status
  - added the optional property `technical_data/need_review_by` to the response with the `201` status
  - added the optional property `technical_data/rejected_by` to the response with the `201` status
- **2025-10-14** `056434c48f8d` — 2 info
  - added the new optional request property `technical_data/portal_steps`
  - added the optional property `technical_data/portal_steps` to the response with the `201` status
- **2025-09-10** `ef18ab7df00d` — 2 info
  - added the new optional request property `technical_data/filtering_score_aml_suspicions`
  - added the optional property `technical_data/filtering_score_aml_suspicions` to the response with the `201` status
- **2025-08-22** `0d70276e679e` — 2 info
  - added the new optional request property `technical_data/active_aml_suspicions`
  - added the optional property `technical_data/active_aml_suspicions` to the response with the `201` status
- …earlier changes not shown

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

---

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