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

# List Shared Stores

> List the shared stores in your organization.

This page documents its request, success response, and error response fields in full.

## Request

### Headers

| Header          | Type   | Required | Allowed value and meaning                                                                 |
| --------------- | ------ | -------- | ----------------------------------------------------------------------------------------- |
| `Authorization` | string | Yes      | `Bearer <Mosaic API key>`. The key determines the organization whose stores are returned. |

This endpoint has no path parameters, query parameters, or JSON request body.

```bash theme={null}
curl "https://api.mosaic.so/shared-stores" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Response

### `200 OK`

```json theme={null}
{
  "stores": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Talent",
      "source_type": "manual",
      "created_at": "2026-08-03T20:00:00Z",
      "updated_at": "2026-08-03T20:00:00Z"
    }
  ]
}
```

| Field                  | Type            | Meaning and possible values                                                                                                   |
| ---------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `stores`               | array           | Every shared store visible to the API key's organization. Empty array or up to 10 items, sorted by `name` ascending.          |
| `stores[]`             | object          | One shared store. The object always contains every field listed below.                                                        |
| `stores[].id`          | UUID string     | Mosaic-generated permanent identifier for the store. Pass this exact value as `{store_id}` in store and entry endpoint paths. |
| `stores[].name`        | string          | Current human-readable store name. Always non-empty.                                                                          |
| `stores[].source_type` | string          | Source label supplied when the store was created. Defaults to `manual`, but may be any non-empty string; this is not an enum. |
| `stores[].created_at`  | ISO 8601 string | UTC timestamp when the store was created.                                                                                     |
| `stores[].updated_at`  | ISO 8601 string | UTC timestamp when the store was last changed. Equals `created_at` until the store is updated.                                |

## Error responses

| Status                      | Payload                                       | Possible value                                                                                                                              |
| --------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `401 Unauthorized`          | `{ "detail": string }`                        | `detail` is exactly `Authorization header must start with Bearer`, `invalid_api_key`, or `API key must be associated with an organization`. |
| `403 Forbidden`             | `{ "detail": "api_access_required" }`         | API access is unavailable for the organization.                                                                                             |
| `500 Internal Server Error` | `{ "error": "Failed to list shared stores" }` | The stores could not be read.                                                                                                               |