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

> List every entry in a shared store.

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

Returns up to the store limit of 10,000 entries, including each entry's metadata.

## Request

### Headers

| Header          | Type   | Required | Allowed value and meaning                                             |
| --------------- | ------ | -------- | --------------------------------------------------------------------- |
| `Authorization` | string | Yes      | `Bearer <Mosaic API key>`. The key's organization must own the store. |

### Path parameters

| Parameter  | Type        | Required | Allowed value and meaning                                     |
| ---------- | ----------- | -------- | ------------------------------------------------------------- |
| `store_id` | UUID string | Yes      | Mosaic-generated `store.id` whose entries should be returned. |

This endpoint has no query parameters or JSON request body.

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

## Response

### `200 OK`

```json theme={null}
{
  "entries": [
    {
      "entry_id": "0689B",
      "display_name": "Jordan Lee",
      "metadata": { "age": 31, "market": "Austin" },
      "created_at": "2026-08-03T20:00:00Z"
    }
  ]
}
```

| Field                    | Type            | Meaning and possible values                                                                                                                                                                             |
| ------------------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `entries`                | array           | Every entry in the requested store. Empty array or up to 10,000 items, sorted by `display_name` ascending.                                                                                              |
| `entries[]`              | object          | One store-scoped entry. The object always contains every field listed below.                                                                                                                            |
| `entries[].entry_id`     | string          | Caller-defined identifier, unique within this store. Use this exact value as `{entry_id}` after URL-encoding it.                                                                                        |
| `entries[].display_name` | string          | Current human-readable entry label. Always non-empty.                                                                                                                                                   |
| `entries[].metadata`     | JSON object     | Caller-controlled structured data. Always an object and never `null`; may be `{}` and may contain nested objects, arrays, strings, numbers, booleans, or `null` values. Maximum encoded size is 256 KB. |
| `entries[].created_at`   | ISO 8601 string | UTC timestamp when this entry ID was first created. Replacing the entry preserves this value.                                                                                                           |

## 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.                                                                                             |
| `404 Not Found`             | `{ "error": "Shared store not found" }`              | The ID does not exist or belongs to another organization.                                                                                   |
| `500 Internal Server Error` | `{ "error": "Failed to list shared store entries" }` | Entries could not be read.                                                                                                                  |