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
curl \
"https://api.mosaic.so/shared-stores/11111111-1111-4111-8111-111111111111/entries" \
-H "Authorization: Bearer mk_your_api_key"Response
200 OK
json
{
"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. |