## List Stores

**get** `/api/v2/public/stores`

Retrieves a paginated list of stores.

### Query Parameters

- `is_warehouse: optional boolean`

  When set, filters stores by warehouse status.

- `page_size: optional string`

  The number of items per page.

- `page_start: optional string`

  The starting page index for pagination.

- `search_text: optional string`

  Optional text to search stores by name or number.

- `secondary_key: optional string`

  Optional secondary search key (max 500 characters).

### Returns

- `list: array of object { storeName, storeNo, id, 17 more }`

  Collection of items for the current page.

  - `storeName: string`

    Display name of the store.

  - `storeNo: string`

    Unique store number.

  - `id: optional number`

    Internal store identifier.

  - `areaDescription: optional string`

    Description of the area.

  - `areaId: optional string`

    Area identifier the store belongs to.

  - `countryCode: optional string`

    ISO country code.

  - `inventLocation: optional string`

    Inventory location code.

  - `isWarhouse: optional boolean`

    Indicates whether this store is a warehouse.

  - `lastOrderLineExportedOn: optional string`

    Date/time of the last exported order line.

  - `legalEntity: optional string`

    Legal entity the store belongs to.

  - `storeStockPool1: optional string`

    Name of stock pool 1.

  - `storeStockPool10: optional string`

    Name of stock pool 10.

  - `storeStockPool2: optional string`

    Name of stock pool 2.

  - `storeStockPool3: optional string`

    Name of stock pool 3.

  - `storeStockPool4: optional string`

    Name of stock pool 4.

  - `storeStockPool5: optional string`

    Name of stock pool 5.

  - `storeStockPool6: optional string`

    Name of stock pool 6.

  - `storeStockPool7: optional string`

    Name of stock pool 7.

  - `storeStockPool8: optional string`

    Name of stock pool 8.

  - `storeStockPool9: optional string`

    Name of stock pool 9.

- `list_body: optional map[unknown]`

  Additional body-level metadata for the list.

- `list_filters: optional map[array of string]`

  Active filter criteria applied to the result set, keyed by field name.

- `next_page: optional number`

  Next page number, or null when on the last page.

- `page_size: optional number`

  Maximum number of items returned per page.

- `page_start: optional number`

  Current page number (1-based).

- `previous_page: optional number`

  Previous page number, or null when on the first page.

- `project_last_modified_date: optional string`

  Last modified date/time of the project.

- `scroll_id: optional string`

  Opaque scroll identifier for deep-pagination scenarios.

- `server_time: optional string`

  Server UTC date/time when the response was generated.

- `sort_column: optional string`

  Column name the results are sorted by.

- `sort_order: optional string`

  Sort direction.

- `task_last_modified_date: optional string`

  Last modified date/time of the task.

- `total_count: optional number`

  Total number of records matching the query across all pages.

### Example

```http
curl https://api.colleqtive.net/api/v2/public/stores \
    -H "Authorization: $COLLEQTIVE_BEARER_TOKEN"
```