# Fetch Departments

Departments are the highest level of catalog organization in Fynd Commerce, representing broad product categories such as *Men's Clothing*, *Accessories*, *Footwear*, *Grocery*, or *Bottomwear*. They serve as the foundation for structuring your product catalog and enabling efficient product discovery across your commerce platform.

The Fetch Departments endpoint retrieves all departments configured for your company, with optional filtering capabilities. Use this API to access department metadata (including IDs, names, slugs, and active status) which is essential when creating products or syncing catalog data between systems. The endpoint supports flexible querying by name, slug, or active status, along with pagination for handling large department lists.

> **Request Type:** `GET`
**Scheme:** `HTTPS`
**Endpoint:** `https://{{host}}/v3/catalog/departments`


Try out Fynd Konnect's Fetch Departments 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 the complete list of departments to populate product creation forms
* Filter departments by name or slug to find specific catalog groupings
* Check active vs. inactive departments to ensure product assignment accuracy
* Build department hierarchies for navigation and catalog organization


### Query Parameters

Filtering Tips
* Use `name` for fuzzy searching across department names
* Use `slug` when you need an exact match for a specific department
* Set `is_active=true` to retrieve only departments currently in use
* Combine filters to narrow down results (e.g., `name=Clothing&is_active=true`)


### Success Response

### API Call Example

### Example Response


```json
{
  "items": [
    {
      "id": 5956,
      "name": "Electronics",
      "slug": "electronics",
      "is_active": true,
      "description": "Electronics department",
      "logo": "https://example.com/electronics.png",
      "created_at": "2023-09-25T10:17:29Z",
      "updated_at": "2023-10-03T09:30:24Z"
    },
    {
      "id": 5957,
      "name": "Men's Clothing",
      "slug": "mens-clothing",
      "is_active": true,
      "description": "Men's apparel and accessories",
      "logo": "https://example.com/mens-clothing.png",
      "created_at": "2023-09-25T10:17:29Z",
      "updated_at": "2023-10-03T09:30:24Z"
    }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 2
}
```

## Best Practices

1. **Cache department data**: Departments rarely change, so cache the response to reduce API calls
2. **Use `is_active` filter**: Always filter by `is_active=true` when assigning products to departments
3. **Store department IDs**: Save department IDs (UIDs) in your system for product creation requests
4. **Handle pagination**: For companies with 50+ departments, implement proper pagination logic
5. **Validate before product creation**: Always verify the department exists and is active before creating products


Next Steps
* To retrieve categories within departments, see [Fetch Categories](/konnect/channels/erp-wms/api-documentation/catalog/get-categories)
* To fetch templates associated with departments, see [Fetch Templates](/konnect/channels/erp-wms/api-documentation/catalog/get-templates)
* To create products with department assignments, 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)