> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search branches

> Search branches by name or code, and filter by status or other fields.

**app\_id** `string` *required*

Your store ID in Jelou Shop.

**page** `integer` (default: 1)

Page number to return.

**limit** `integer` (default: 15)

Number of results per page (max. 100).

**search** `object`

Text search object.

**Search properties**

**value** `string` *required*

Text to search in the `name` and `code` fields.

**case\_sensitive** `boolean` (default: false)

Whether the search is case-sensitive.

**filters** `object[]`

List of filters to apply.

**Properties of each filter**

**field** `string` *required*

Field to filter by: `status` or `code`.

**operator** `string` (default: =)

Comparison operator. Supported values: `=`, `!=`, `<`, `<=`, `>`, `>=`, `like`, `not like`, `in`, `not in`.

**value** `string | boolean` *required*

Filter value.

**sort** `object[]`

Result ordering.

**Properties of each sort**

**field** `string` *required*

Field to sort by: `created_at`, `updated_at`, `name` or `code`.

**direction** `string` (default: asc)

Sort direction: `asc` or `desc`.

```bash cURL theme={null}
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches/search?page=1&limit=20" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search": {
      "value": "downtown",
      "case_sensitive": false
    },
    "filters": [
      { "field": "status", "operator": "=", "value": true }
    ],
    "sort": [
      { "field": "name", "direction": "asc" }
    ]
  }'
```

> [!NOTE]
>
> Each branch in the response includes `products_count` with the number of **active** products linked to it. If you omit `sort`, results are ordered by `created_at` ascending.

> [!TIP]
>
> **Searchable fields:** `name`, `code`
> **Filterable fields:** `status`, `code`
> **Sortable fields:** `created_at`, `updated_at`, `name`, `code`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.