Search by HS Code

This service retrieves Turkey Customs Tariff Schedule data corresponding to a given HS code. All matching records starting with the code are listed along with their description information. This allows access to details for the correct product.

Endpoint Information

Request Parameters

Path Parameters

Example Usage

API Request

Below is an example HTTP raw request for the API request. In this example, all HS code records starting with 0203 are queried. This code represents pork-related products.

GET {{APP_URL}}/api/v1/gtip/search/code/0203
Content-Type: application/json
APIKEY: {{APIKEY}}

API Response

On a successful request, the API will return a response like the following:

{
    "status": true,
    "message": null,
    "data": [
        {
            "id": "10",
            "code": "0203",
            "description": "Domuz eti (taze, soğutulmuş veya dondurulmuş):",
            "description_en": "Meat of swine (fresh, chilled or frozen):"
        },
        {
            "id": "1155",
            "code": "020311100000",
            "description": "Domuz eti (taze, soğutulmuş veya dondurulmuş): > Karkas veya yarım karkas : > Evcil domuz eti",
            "description_en": "Meat of swine (fresh, chilled or frozen): > Carcases and half-carcases: > Of domestic swine"
        }
    ]
}

Response Summary: As a result of the search, all HS code records starting with 0203 are returned. These records include both the 4-digit main heading and the 12-digit sub-product classifications linked to it.

Error Responses

If the API request fails, the API will return an error response like the following:

{
    "status": false,
    "errors": [
        {
            "message": "code:This value is not valid."
        }
    ]
}