FlavorCloud Partner API Documentation
  1. Classifications
FlavorCloud Partner API Documentation
  • Authentication
    • Get Auth Token
      POST
  • Rates
    • Get Rates
      POST
    • Get Multi Rates
      POST
    • Get Rate Detail
      GET
    • Get Quote
      POST
    • Get Multi Quote
      POST
  • Shipments
    • Create Shipments
      POST
    • Create Multi-Package Shipments
      POST
    • Get Shipments
      GET
    • Cancel Shipments
      PUT
  • Tracking
    • Get Tracking Detail
      GET
  • Batches
    • Create Batch
      POST
    • Update Batch - Add Shipment
      PUT
    • Update Batch - Remove Shipment
      PUT
    • Close Batch
      POST
    • Get Batch
      GET
  • Classifications
    • Get Classification
      POST
  • Customer
    • Add Customer
      POST
    • Get Customers
      GET
  • Landed Cost
    • Get Landed Cost
      POST
  • Manifest
    • Manifest Shipment
      POST
    • Get Manifest
      GET
  • Webhooks
    • Subscribe Webhooks
    • Unsubscribe Webhooks
  • Invoices
    • Get Invoice Detail
    • Get Invoices
  1. Classifications

Get Classification

POST
/Classifications
Classification
The Classification endpoint is a tool for accurately determining the Harmonized System (HS) codes that correspond to a given product description. HS codes are used by customs authorities to classify and identify products for the purposes of trade and taxation. Accurate description for classification is essential for compliance with international trade regulations and can impact tariffs, duties, and other fees.
Shipments created that have products with missing or incorrect HS codes will only ship DDU even if DDP is the selected option. All products must be classified properly.
Find HSCode Based On Description. The first two digits identify the category of the goods, known as the ‘Chapter’ (e.g. HS-18 would mean cocoa and cocoa preparation). The next two digits, known as ‘Heading’, identify sub-groups e.g. HS-1806 indicates chocolate and other foods containing cocoa. The next two digits, known as ‘Subheading’, are even more specific, e.g. HS-180610 refers to added sugar or other sweeteners.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
Reference
string 
optional
This field is for your reference., A good use of it would be to provide your order number here.
Products
array [object {6}] 
optional
Description
string 
required
Description of the product
Image
string 
optional
Image url of the product
Title
string 
optional
Title of the product
Category
string 
optional
Category type of product. Please use valid categories found here: https://shopify.github.io/product-taxonomy/releases/2024-07/
SubCategory
string 
optional
Sub Category type of product
Material
string 
optional
Product material description
Example
{
  "Reference": "123456",
  "Products": [
    {
      "Description": "Cotton Mens T-shirt",
      "Image": "",
      "Title": "High Quality Egyptian Cotton T-Shirt, 1000 thread count",
      "Category": "Apparel",
      "SubCategory": "Mens Clothing",
      "Material": "Cotton"
    }
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://partnerapi.flavorcloud.com/Classifications' \
--header 'Content-Type: application/json' \
--data-raw '{
  "Reference": "123456",
  "Products": [
    {
      "Description": "Cotton Mens T-shirt",
      "Image": "",
      "Title": "High Quality Egyptian Cotton T-Shirt, 1000 thread count",
      "Category": "Apparel",
      "SubCategory": "Mens Clothing",
      "Material": "Cotton"
    }
  ]
}'

Responses

🟢200Classification Response
application/json
Body
Products
array[object (ProductResponse) {4}] 
optional
Classification
object (ClassificationStatus) 
optional
Description
string 
optional
Image
string 
optional
Title
string 
optional
Example
{
  "Products": [
    {
      "Classification": {
        "HSCode": "string",
        "Success": true,
        "HSChapter": "string",
        "HSChapterDescription": "string",
        "HSHeading": "string",
        "HSHeadingDescription": "string",
        "HSSubHeading": "string",
        "HSSubHeadingDescription": "string"
      },
      "Description": "string",
      "Image": "string",
      "Title": "string"
    }
  ]
}
🟠401Authentication Error
🟠422Validation Error
🔴500Error Response
Previous
Get Batch
Next
Add Customer
Built with