> For the complete documentation index, see [llms.txt](https://transiteo.gitbook.io/transiteo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://transiteo.gitbook.io/transiteo/duties-and-taxes-services/hscode-services/a.i-customs-code-control.md).

# A.I Customs Code Control

## Control with A.I if the HSCode be equivalent to product title or description

<mark style="color:green;">`POST`</mark> `https://api.transiteo.io/v1/customscode/control`

**Headers**

| Name          | Value                 |
| ------------- | --------------------- |
| Content-Type  | `application/json`    |
| Authorization | id token from cognito |

### JSON REQUEST FORMAT

```
{
    "requests": [
        {
            "hscode": "9506620090",
            "to_country": "FRA",
            "text": "Ballon de football"
        },
        {
            "hscode": "6505003100",
            "to_country": "FRA",
            "text": "Boite de thon"
        }
    ]
}
```

**Response**

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

```json
[
    {
        "scoring_control": 86.9,
        "hscodes_proposals": [
            {
                "hscode": "9506620000",
                "score": 69
            },
            {
                "hscode": "9506699000",
                "score": 25.9
            },
            {
                "hscode": "9506999000",
                "score": 1.2
            }
        ]
    },
    {
        "scoring_control": 3.56,
        "hscodes_proposals": [
            {
                "hscode": "1604142100",
                "score": 35.6
            },
            {
                "hscode": "1604142800",
                "score": 24.7
            },
            {
                "hscode": "1604144890",
                "score": 14.1
            }
        ]
    }
]
```

{% endtab %}

{% tab title="400" %}

```json
Incorrect Json (json body request incorrect) : a description of the error will be returned
```

{% endtab %}

{% tab title="403" %}

```
wrong token id or token has expired
```

{% endtab %}

{% tab title="500" %}

```
{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}
```

{% endtab %}
{% endtabs %}