# Fetch HS Codes

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.

Important: Tax Compliance
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
br
**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` |


Use Cases
* 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


### Query Parameters

Search Tips
* Use `search` with code value (e.g., "6205") or description keywords (e.g., "shirts")
* Set `type=HS` to retrieve only codes for physical goods
* Set `type=SAC` to 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


### Success Response

### API Call Example

### Example Response


```json
{
  "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
}
```

## Best Practices

1. **Cache HS/SAC code data**: Codes rarely change; implement caching to reduce API calls and improve performance
2. **Use active codes only**: Filter for `is_active: true` codes when creating products
3. **Verify with tax advisors**: Always validate HS/SAC code assignments with your tax or compliance team
4. **Store codes in your system**: Save HS/SAC code values for efficient product creation and updates
5. **Search by description**: Use the `search` parameter with product type keywords to find relevant codes
6. **Filter by type**: Use `type=HS` for physical products and `type=SAC` for services
7. **Handle pagination**: Implement proper pagination for companies with extensive code lists
8. **Check country applicability**: Verify the `country_iso` matches your target market


Next Steps
* To retrieve tax rules associated with HS codes, see [Fetch Tax Rule IDs](/konnect/channels/erp-wms/api-documentation/catalog/get-tax-rule-ids)
* To fetch departments for product organization, see [Fetch Departments](/konnect/channels/erp-wms/api-documentation/catalog/get-departments)
* To create products with HS/SAC codes, see [Create Product](/konnect/channels/erp-wms/api-documentation/catalog/post-create-product)
* For complete catalog setup workflow, see [Catalog Management Guide](/konnect/channels/erp-wms/whats-new/catalog-management)