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

# Get an Entry

> Get one shared-store entry.

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's organization must own the store. |

### Path parameters

| Parameter  | Type        | Required | Allowed value and meaning                                                                       |
| ---------- | ----------- | -------- | ----------------------------------------------------------------------------------------------- |
| `store_id` | UUID string | Yes      | Mosaic-generated `store.id` containing the requested entry.                                     |
| `entry_id` | string      | Yes      | Exact non-empty caller-defined entry ID within that store. URL-encode reserved path characters. |

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/0689B" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Response

### `200 OK`

```json theme={null}
{
  "entry": {
    "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                                                                                                                                                                             |
| -------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `entry`              | object          | The complete store-scoped entry matching `{entry_id}`. The object always contains every field listed below.                                                                                             |
| `entry.entry_id`     | string          | Caller-defined identifier, unique within the store. It exactly matches the stored ID addressed by `{entry_id}`.                                                                                         |
| `entry.display_name` | string          | Current human-readable entry label. Always non-empty.                                                                                                                                                   |
| `entry.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. |
| `entry.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 store does not exist or belongs to another organization.                                                                                |
| `404 Not Found`             | `{ "error": "Shared store entry not found" }`     | The entry ID does not exist in the store.                                                                                                   |
| `500 Internal Server Error` | `{ "error": "Failed to get shared store entry" }` | The entry could not be read.                                                                                                                |