DOdotfile
Companies

Set company relevance

Changed on

Change the relevance of the specified company

post/v1/companies/{id}/set-relevant

Request

  • Base URL
    https://api.dotfile.com
  • Auth
    API key in header X-DOTFILE-API-KEY

Path parameters

idstring uuid required

Id of the company

Request body

is_relevantboolean required

Response

ℹ️ Click to see full payload

idstring uuid required
case_idstring uuid required
type'main' | 'affiliated' required
namestring required
is_relevantboolean required
commercial_namestring nullable required
countrystring alpha-2 nullable required

ISO 3166-1 alpha-2 country code (eg FR)

registration_numberstring nullable required
registration_datestring date nullable required

Date in format ISO 8601(yyyy-MM-dd eg 2023-01-31)

status'live' | 'closed' | 'not_reported' required
legal_formstring nullable required
entity_legal_formstring nullable required

ISO 20275 code (eg: 6CHY)

entity_legal_form_labelstring nullable required

Label in the origin country language of the ISO 20275 code.
May contains multiple labels separated with a comma , when the code is assigned to multiple label in different languages.

share_capitalstring nullable required
tax_identification_numberstring nullable required
website_urlstring nullable required
employer_identification_numberstring nullable required
custom_propertiesobject 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.

created_atstring date-time required

Creation date
Date time in format ISO 8601 (yyyy-MM-ddTHH:mm:ss.S+X eg 2023-01-31T13:30:00.000Z)

updated_atstring date-time required

Latest update date
Date time in format ISO 8601 (yyyy-MM-ddTHH:mm:ss.S+X eg 2023-01-31T13:30:00.000Z)

last_activity_atstring date-time required

Latest activity date
Date time in format ISO 8601 (yyyy-MM-ddTHH:mm:ss.S+X eg 2023-01-31T13:30:00.000Z)

data_lineageobject

Data lineage keyed by property path, returned only when data_lineage=true is provided.

Example response

{
  "banking_information": {
    "iban": "FR7630006000011234567890189",
    "bic": "AGRIFRPPXXX"
  },
  "custom_properties": {
    "custom_text": "Custom properties text",
    "custom_boolean": true,
    "custom_date": "2012-12-12",
    "custom_countries": [
      "FR"
    ],
    "custom_choices": [
      "option1",
      "option2"
    ],
    "custom_numeric": 12.3,
    "custom_property": null
  }
}

Changes

  • 50cab516e856Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      added the new email_phone_verification enum value to the // response property for the response status

    • info

      added the optional property to the response with the status