Change company data

Overview

Use this endpoint to change the company data. With this method, you patch the fields in the companyInfo object of the company profile.

This method is rather beneficial because you do not need to create another profile when obtaining new information about the company, you just make this PATCH request instead.

Mind that if you need to re-check the company once the information has been changed, you need to revert the company verification status to pending by initiating another review.

🚧

Important

  • When making a request, the body parameters must contain all of the fields that have values. Null fields at the companyInfo will be unset. You can get the previously filled data with this method.
  • A patched info entity could be quite damaging if misused. It is recommended to check in the sandbox environment if the response returns expected results.

Request example

curl -X PATCH \
  'https://api.sumsub.com/resources/applicants/5b76df770a975a1404cbcb60/info/companyInfo' \
  -H 'Content-Type: application/json' \
  -d '{
          "companyName": "your_company_name",
          "registrationNumber": "7836733",
          "country": "GBR",
          "website": "yourcompany.com",
          "noUBOs": false,
          "beneficiaries": [
           {
              "applicantId": "5e95717e0a975a723e187cde",
              "positions": null,
              "type": "ubo",
              "inRegistry": false,
              "imageIds": null,
              "applicant": null
           },
           {
              "applicantId": "5e9571a30a975a723e187ce9",
              "positions": ["shareholder"],
              "type": "shareholder",
              "inRegistry": false,
              "imageIds": null,
              "applicant": null
           }
          ]
      }'

Response explained

If the request is successfully sent and processed, you will get a JSON file that contains the companyInfo object with the data changed.

You can see the companyInfo structure and possible content with descriptions in the following table.

Response example

{
  "companyName": "your_company_name",
  "registrationNumber": "7836733",
  "country": "GBR",
  "website": "yourcompany.com",
  "noUBOs": false,
  "beneficiaries": [
    {
      "applicantId": "5e95717e0a975a723e187cde",
      "positions": null,
      "type": "ubo",
      "inRegistry": false,
      "imageIds": null,
      "applicant": null
    },
    {
      "applicantId": "5e9571a30a975a723e187ce9",
      "positions": [
        "shareholder"
      ],
      "type": "shareholder",
      "inRegistry": false,
      "imageIds": null,
      "applicant": null
    }
  ]
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!