> ## 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.

# Buscar sucursales

> Busca sucursales por nombre o código, y filtra por estado u otros campos.

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

ID de tu tienda en Jelou Shop.

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

Número de página a retornar.

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

Cantidad de resultados por página (máx. 100).

**search** `object`

Objeto de búsqueda por texto.

**Propiedades de búsqueda**

**value** `string` *required*

Texto a buscar en los campos `name` y `code`.

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

Define si la búsqueda distingue entre mayúsculas y minúsculas.

**filters** `object[]`

Lista de filtros a aplicar.

**Propiedades de cada filtro**

**field** `string` *required*

Campo por el que filtrar: `status` o `code`.

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

Operador de comparación. Valores soportados: `=`, `!=`, `<`, `<=`, `>`, `>=`, `like`, `not like`, `in`, `not in`.

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

Valor del filtro.

**sort** `object[]`

Ordenamiento de resultados.

**Propiedades de cada sort**

**field** `string` *required*

Campo por el que ordenar: `created_at`, `updated_at`, `name` o `code`.

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

Dirección del orden: `asc` o `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: TU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "search": {
      "value": "centro",
      "case_sensitive": false
    },
    "filters": [
      { "field": "status", "operator": "=", "value": true }
    ],
    "sort": [
      { "field": "name", "direction": "asc" }
    ]
  }'
```

> [!NOTE]
>
> Cada sucursal de la respuesta incluye `products_count` con la cantidad de productos **activos** asociados. Si no envías `sort`, los resultados se ordenan por `created_at` ascendente.

> [!TIP]
>
> **Campos buscables:** `name`, `code`
> **Campos filtrables:** `status`, `code`
> **Campos ordenables:** `created_at`, `updated_at`, `name`, `code`


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