HS (Harmonized System) Codes and SAC (Service Accounting Codes) are standardized classification systems used to identify and categorize goods and services for taxation, customs, and trade purposes. In India, HS codes apply to physical goods, while SAC codes are used for services. These codes are essential for accurate GST calculation, customs clearance, and regulatory compliance in e-commerce operations.
The Fetch HS Codes endpoint retrieves all HS/SAC codes configured for your company on the Fynd Platform. Use this API to access code metadata (including code values, descriptions, types, and countries) which is required when creating products or managing tax configurations. The endpoint supports flexible querying by search term, code type (HS or SAC), and pagination for handling extensive code lists.
Assigning the correct HS/SAC code to products is crucial for tax compliance. Incorrect codes can lead to improper GST calculations, customs issues, and regulatory penalties. Always verify code accuracy with your tax advisor
Request Type:
GET
Scheme:HTTPS
Endpoint:https://{{host}}/v3/catalog/taxes/hscodes
Try out Fynd Konnect's Fetch HS Codes Endpoint
Common Request Headers
| Header | Mandatory | Description |
|---|---|---|
x-access-token | Yes | Access token used for authenticating API requests to Fynd Konnect |
Content-Type | Yes | application/json |
- Retrieve all HS/SAC codes to populate product creation forms
- Search for specific codes by description or code value
- Filter codes by type (HS for goods, SAC for services)
- Validate HS/SAC codes before product creation to ensure tax compliance
- Sync tax classification data between your ERP/WMS and Fynd Commerce
Search by HS/SAC code value or description (partial match supported)
Filter by code type: HS for goods, SAC for services
Page number for pagination (default: 1)
Number of items to retrieve per page (default: 10)
- Use
searchwith code value (e.g., "6205") or description keywords (e.g., "shirts") - Set
type=HSto retrieve only codes for physical goods - Set
type=SACto retrieve only codes for services - Leave filters empty to retrieve all HS/SAC codes in your company's catalog
- Implement pagination for companies with extensive code lists
List of HS/SAC codes matching the query filters
Current page number in the paginated response
Number of items returned in this page
Total number of HS/SAC codes available matching the query
- Fynd Konnect [Sandbox]https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/taxes/hscodes
curl -i -X GET \
'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/taxes/hscodes?search=string&type=HS&page_number=1&page_size=1' \
-H 'x-access-token: YOUR_API_KEY_HERE'{
"items": [
{
"id": "hscode_12345",
"code": "62052000",
"description": "Men's Or Boys' Shirts, Singlets And Other Vests, Of Cotton",
"type": "HS",
"tax_rate": 0.12,
"category": "Clothing",
"subcategory": "Shirts",
"is_active": true,
"country_iso": "IN",
"created_at": "2023-01-15T10:30:00Z",
"updated_at": "2023-12-01T15:45:00Z"
}
],
"page_number": 1,
"page_size": 10,
"total": 150
}- Cache HS/SAC code data: Codes rarely change; implement caching to reduce API calls and improve performance
- Use active codes only: Filter for
is_active: truecodes when creating products - Verify with tax advisors: Always validate HS/SAC code assignments with your tax or compliance team
- Store codes in your system: Save HS/SAC code values for efficient product creation and updates
- Search by description: Use the
searchparameter with product type keywords to find relevant codes - Filter by type: Use
type=HSfor physical products andtype=SACfor services - Handle pagination: Implement proper pagination for companies with extensive code lists
- Check country applicability: Verify the
country_isomatches your target market
- To retrieve tax rules associated with HS codes, see Fetch Tax Rule IDs
- To fetch departments for product organization, see Fetch Departments
- To create products with HS/SAC codes, see Create Product
- For complete catalog setup workflow, see Catalog Management Guide