---
title: "Get all stores"
method: GET
path: "/stores"
tags: ["Stores"]
---

# Get all stores

`GET /stores`

Get information as a list of all stores.

## Query parameters

- `count` integer
- `offset` integer
- `sort_field` string
- `sort_direction` 'ASC' | 'DESC'
- `visible_for_customer` 0 | 1
- `property_id` string
- `property_value` string
- `system_id` string

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `data` object
    - `stores` Store[] — List of all stores.
      - `store_id` string, required — The unique ID of the store in CareCloud.
      - `store_code` string, required — External code of the store.
      - `name` string, required — Name of the store.
      - `store_address` Address — The Address Structure in the API defines the standardized format for representing addresses throughout the system. This resource ensures consistency and accuracy in capturing address details, facilitating seamless integration and data exchange.
        - `address1` string — Street name of the address.
        - `address2` string — Street number (Land registry number).
        - `address3` string — House number.
        - `address4` string — Next address data.
        - `address5` string — Next address data.
        - `address6` string — Next address data.
        - `address7` string — Next address data.
        - `zip` string — ZIP code.
        - `city` string — City.
        - `country_code` string — ISO code of the country. *Possible values de / gb / us / it / cz / etc*
      - `contact_email` string — Contact email of the store.
      - `manager_name` string — Name of the store manager.
      - `phone_number` string — Phone number of the store with international prefix (420000000000).
      - `partner_id` string, required — The unique ID of the partner. [GET /partners](https://carecloud.readme.io/reference/getpartners)
      - `system_id` string, required — The external unique ID of the store in external system.
      - `gps_coordinates` GPSCoordinates — GPS coordinates of the store.
        - `gps_longitude` number, float, required — GPS longitude.
        - `gps_latitude` number, float, required — GPS latitude.
      - `url_address` string — URL address of the store.
      - `opening` OpeningDay[] — List of opening days.
        - `day_id` string, required — The unique ID of the day of the week.
        - `time_intervals` TimeInterval[], required — List of time Intervals.
          - `from` string, required — Time from. *(HH:MM:SS)*
          - `to` string, required — Time to. *(HH:MM:SS)*
      - `image_urls` string[] — A list of image URL addresses.
      - `visibility_for_customer` 0 | 1 — State of the visibility for the customer. *Possible values are: 0 - invisible / 1 - visible*
      - `short_description` string — Short description of the store.
      - `description` string — Long description of the store.
      - `registration_id` string — Legal registration number of the store.
      - `last_change` string — Date and time of the last change. *(YYYY-MM-DD HH:MM:SS)*
      - `state` 0 | 1 | 2 — State of the store *Possible values are: 0 - deleted / 1 - active / 2 - non active*
    - `total_items` integer — The number of all found stores.

## Other responses

- `400` — Bad input parameter. The response body's `error.error_data.invalid_params[]` array lists the parameters that caused the failure, each carrying a `reason` code. See the `BadRequestErrorBody` schema for the generic reason taxonomy. Operations with domain-specific business rules document additional reasons at the operation level.
- `401` — The client has invalid credentials or auth token.
- `403` — The client does not exist or the client tried to access an unauthorized property or resource.
- `404` — The resource was not found.
- `405` — The resource does not support the specified HTTP method.
- `429` — Too many requests - more than the resource limit.
- `500` — Server is not working as expected.
- `503` — Temporary state when the service is temporarily unavailable, overloaded or there is a maintenance window.

---

[API](https://skmtc.net/crmcarecloud/apis/rest-api-reference.md) · [All operations](https://skmtc.net/crmcarecloud/apis/rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crmcarecloud/rest-api-reference/revisions/329c06dbf8d9/schema)