# Update Certified Entity Details

## This endpoint allows you to update Certified Entity details specified with its GUID.

<mark style="color:orange;">`PUT`</mark> `https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid`

The `company_guid` field is always required. Other fields that are marked with an asterisk (\*) are mandatory if present in the request body.

#### Headers

| Name                                                   | Type   | Description                                                                                                                                                             |
| ------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>         | String | application/json                                                                                                                                                        |
| x-http-authorization<mark style="color:red;">\*</mark> | String | <p>API Key received from <https://iafcertsearch.org/import-management/api-integration></p><p></p><p>Example: </p><p><code>x-http-authorization: <\<API KEY>></code></p> |

#### Request Body

| Name                                               | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| company\_guid<mark style="color:red;">\*</mark>    | String | A unique identifier for a specific Certified Entity. Used as a reference or a tracking number to look up Certified Entity records in the IAF CertSearch database.                                                                                                                                                                                                                                                                                           |
| company\_website                                   | String | Company Website                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| company\_postcode                                  | String | Company Post Code                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| company\_state                                     | String | Company State                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| company\_city                                      | String | Company City                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| company\_street                                    | String | Company Street                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| company\_en\_name                                  | String | <p>Company English Name<br><br>Example:<br><br>Test Food and Logistics Inc. English Name<br>Reliable Logistics Services Inc. English Name</p>                                                                                                                                                                                                                                                                                                               |
| company\_trading\_name                             | String | <p>Company Trading Name<br><br>Example:<br><br>Test Food and Logistics Inc. Trading Name<br>Reliable Logistics Services Inc. Trading Name</p>                                                                                                                                                                                                                                                                                                               |
| system\_information                                | String | <p>System Information<br><br>Information of a specific Certified Entity used by the IAF CertSearch database.<br><br>Example:<br><br>"system\_information" : {</p><p>   "company\_name" : "string",</p><p>   "company\_guids" : \[</p><p>       "string", </p><p>      "string" </p><p>   ]</p><p>},</p><p>or</p><p>"system\_information": \[</p><p>   {</p><p>      "company\_name": "string",</p><p>      "company\_guid": "string"</p><p>   }</p><p>]</p> |
| company\_country<mark style="color:red;">\*</mark> | String | Country/Economy of the main entity address for the certified entity.                                                                                                                                                                                                                                                                                                                                                                                        |
| company\_id\_number                                | String | <p>Company Identification Number </p><p></p><p>Example: </p><p></p><p>U12345ABCDE12345F123456</p>                                                                                                                                                                                                                                                                                                                                                           |
| business\_registration\_number                     | String | <p>Business Registration Number </p><p></p><p>Example: </p><p></p><p>1234567890A</p>                                                                                                                                                                                                                                                                                                                                                                        |
| tax\_id                                            | String | <p>Tax Identification </p><p></p><p>Example: </p><p></p><p>000123456001</p>                                                                                                                                                                                                                                                                                                                                                                                 |

{% tabs %}
{% tab title="200: OK Request successful." %}

```javascript
{
    "data": {
        "company_id": "string",
        "company_name": "string",
        "company_trading_name": "string",
        "company_street": "string",
        "company_city": "string",
        "company_suburb": "string",
        "company_postcode": "string",
        "company_state": "string",
        "company_country": "string",
        "company_email": "string",
        "company_status": "string",
        "company_type": "string",
        "company_contact": "string",
        "company_logo": "[]",
        "company_banner": "[]",
        "countries_id": number,
        "company_website": "string",
        "company_tz": number,
        "company_tz_text": "string",
        "company_hash": "string",
        "company_guid": "string",
        "company_phone": "string",
        "company_business_type": "string",
        "company_address": "string",
        "company_en_name": "string",
        "tax_id": "string",
        "business_reg_number": "string",
        "company_id_number": "string",
        "qualitytrade_id": number,
        "qualitytrade_hash": "string"    ,
        "company_search_limit": number,
        "is_confidential": number,
        "activated_at": date,
        "created_at": date,
        "updated_at": date
    }
}
```

{% endtab %}

{% tab title="400: Bad Request Other errors that is described in the API response." %}

```javascript
{
    "error": true,
    "timestamp": number (Epoch time),
    "elapse": number,
    "errors": {
      "message": "error_message",
      "code": "error_code"
    }
}
```

{% endtab %}

{% tab title="401: Unauthorized Happens when you use invalid API key." %}

```javascript
{
    "error": true,
    "timestamp": number (Epoch time),
    "elapse": number,
    "errors": {
      "message": "Invalid Session token has been used.",
      "code": "invalid_session_token"
    }
}
```

{% endtab %}

{% tab title="422: Unprocessable Entity Did not pass parameter validation" %}

```javascript
{
    "error": true,
    "timestamp": number (Epoch time),
    "elapse": number,
    "errors": {
        "code": "validation_error",
        "message": {
            "field_name": "error_message"
        }
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
To view the response data example, click the right arrow at the right side of the response description.
{% endhint %}

{% hint style="info" %}
You can also use <https://api.sandbox.iafcertsearch.org/api/client/v1/mncb/ce-by-guid> to test it on the Sandbox server.
{% endhint %}

Take a look at how you might call this method:

{% tabs %}
{% tab title="cURL" %}

```shell
curl --location --request PUT 'https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid' \
--header 'x-http-authorization: <<API_KEY>>' \
--header 'Content-Type: application/json' \
--header 'User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36' \
--data-raw '{
    "company_guid" : "string",
    "company_trading_name": "string",
    "company_en_name": "string",
    "company_country": "string",
    "company_street": "string",
    "company_city": "string",
    "company_state": "string",
    "company_postcode": "string",
    "company_website": "string",
    "tax_id": "string",
    "business_registration_number": "string",
    "company_id_number": "string",
    "system_information":{
        "company_name": "string",
        "company_guids": [
            "string",
            "string"
        ]
    }
}'
```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require "uri"
require "json"
require "net/http"

url = URI("https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-http-authorization"] = "<<API_KEY>>"
request["Content-Type"] = "application/json"
request["User-Agent"] = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36"
request.body = JSON.dump({
  "company_guid": "string",
  "company_trading_name": "string",
  "company_en_name": "string",
  "company_country": "string",
  "company_street": "string",
  "company_city": "string",
  "company_state": "string",
  "company_postcode": "string",
  "company_website": "string",
  "tax_id": "string",
  "business_registration_number": "string",
  "company_id_number": "string",
  "system_information": {
    "company_name": "string",
    "company_guids": [
      "string",
      "string"
    ]
  }
})

response = https.request(request)
puts response.read_body

```

{% endtab %}

{% tab title="Python" %}

```python
import http.client
import json

conn = http.client.HTTPSConnection("api.iafcertsearch.org")
payload = json.dumps({
  "company_guid": "string",
  "company_trading_name": "string",
  "company_en_name": "string",
  "company_country": "string",
  "company_street": "string",
  "company_city": "string",
  "company_state": "string",
  "company_postcode": "string",
  "company_website": "string",
  "tax_id": "string",
  "business_registration_number": "string",
  "company_id_number": "string",
  "system_information": {
    "company_name": "string",
    "company_guids": [
      "string",
      "string"
    ]
  }
})
headers = {
  'x-http-authorization': '<<API_KEY>>',
  'Content-Type': 'application/json',
  'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36'
}
conn.request("PUT", "/api/client/v1/mncb/ce-by-guid", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_POSTFIELDS =>'{
    "company_guid" : "string",
    "company_trading_name": "string",
    "company_en_name": "string",
    "company_country": "string",
    "company_street": "string",
    "company_city": "string",
    "company_state": "string",
    "company_postcode": "string",
    "company_website": "string",
    "tax_id": "string",
    "business_registration_number": "string",
    "company_id_number": "string",
    "system_information":{
        "company_name": "string",
        "company_guids": [
            "string",
            "string"
        ]
    }
}',
  CURLOPT_HTTPHEADER => array(
    'x-http-authorization: <<API_KEY>>',
    'Content-Type: application/json',
    'User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

```

{% endtab %}

{% tab title="Java" %}

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"company_guid\" : \"string\",\r\n    \"company_trading_name\": \"string\",\r\n    \"company_en_name\": \"string\",\r\n    \"company_country\": \"string\",\r\n    \"company_street\": \"string\",\r\n    \"company_city\": \"string\",\r\n    \"company_state\": \"string\",\r\n    \"company_postcode\": \"string\",\r\n    \"company_website\": \"string\",\r\n        \"tax_id\": \"string\",\r\n        \"business_registration_number\": \"string\",\r\n        \"company_id_number\": \"string\",\r\n        \"system_information\":{\r\n        \"company_name\": \"string\",\r\n        \"company_guids\": [\r\n            \"string\",\r\n            \"string\"\r\n        ]\r\n    }\r\n}");
Request request = new Request.Builder()
  .url("https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid")
  .method("PUT", body)
  .addHeader("x-http-authorization", "<<API_KEY>>")
  .addHeader("Content-Type", "application/json")
  .addHeader("User-Agent", "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36")
  .build();
Response response = client.newCall(request).execute();
```

{% endtab %}

{% tab title="Node" %}

```javascript
var axios = require('axios');
var data = JSON.stringify({
  "company_guid": "string",
  "company_trading_name": "string",
  "company_en_name": "string",
  "company_country": "string",
  "company_street": "string",
  "company_city": "string",
  "company_state": "string",
  "company_postcode": "string",
  "company_website": "string",
  "tax_id": "string",
  "business_registration_number": "string",
  "company_id_number": "string",
  "system_information": {
    "company_name": "string",
    "company_guids": [
      "string",
      "string"
    ]
  }
});

var config = {
  method: 'put',
  url: 'https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid',
  headers: { 
    'x-http-authorization': '<<API_KEY>>', 
    'Content-Type': 'application/json', 
    'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

```

{% endtab %}

{% tab title="Go" %}

```go
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid"
  method := "PUT"

  payload := strings.NewReader(`{`+"
"+`
    "company_guid" : "string",`+"
"+`
    "company_trading_name": "string",`+"
"+`
    "company_en_name": "string",`+"
"+`
    "company_country": "string",`+"
"+`
    "company_street": "string",`+"
"+`
    "company_city": "string",`+"
"+`
    "company_state": "string",`+"
"+`
    "company_postcode": "string",`+"
"+`
    "company_website": "string",`+"
"+`
    "tax_id": "string",`+"
"+`
    "business_registration_number": "string",`+"
"+`
    "company_id_number": "string",`+"
"+`
        "system_information":{`+"
"+`
        "company_name": "string",`+"
"+`
        "company_guids": [`+"
"+`
            "string",`+"
"+`
            "string"`+"
"+`
        ]`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("x-http-authorization", "<<API_KEY>>")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("User-Agent", "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
var client = new RestClient("https://api.iafcertsearch.org/api/client/v1/mncb/ce-by-guid");
client.Timeout = -1;
var request = new RestRequest(Method.PUT);
request.AddHeader("x-http-authorization", "<<API_KEY>>");
request.AddHeader("Content-Type", "application/json");
client.UserAgent = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36";
var body = @"{
" + "\n" +
@"    ""company_guid"" : ""string"",
" + "\n" +
@"    ""company_trading_name"": ""string"",
" + "\n" +
@"    ""company_en_name"": ""string"",
" + "\n" +
@"    ""company_country"": ""string"",
" + "\n" +
@"    ""company_street"": ""string"",
" + "\n" +
@"    ""company_city"": ""string"",
" + "\n" +
@"    ""company_state"": ""string"",
" + "\n" +
@"    ""company_postcode"": ""string"",
" + "\n" +
@"    ""company_website"": ""string"",
" + "\n" +
@"    ""tax_id"": ""string"",
" + "\n" +
@"    ""business_registration_number"": ""string"",
" + "\n" +
@"    ""company_id_number"": ""string"",
" + "\n" +
@"        ""system_information"":{
" + "\n" +
@"        ""company_name"": ""string"",
" + "\n" +
@"        ""company_guids"": [
" + "\n" +
@"            ""string"",
" + "\n" +
@"            ""string""
" + "\n" +
@"        ]
" + "\n" +
@"    }
" + "\n" +
@"}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```

{% endtab %}
{% endtabs %}
