Skip to content
Dashboard
API Reference

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 ​

HeaderTypeRequiredAllowed value and meaning
AuthorizationstringYesBearer <Mosaic API key>. The key's organization must own the store.

Path parameters ​

ParameterTypeRequiredAllowed value and meaning
store_idUUID stringYesMosaic-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"
    }
  ]
}
FieldTypeMeaning and possible values
entriesarrayEvery entry in the requested store. Empty array or up to 10,000 items, sorted by display_name ascending.
entries[]objectOne store-scoped entry. The object always contains every field listed below.
entries[].entry_idstringCaller-defined identifier, unique within this store. Use this exact value as {entry_id} after URL-encoding it.
entries[].display_namestringCurrent human-readable entry label. Always non-empty.
entries[].metadataJSON objectCaller-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_atISO 8601 stringUTC timestamp when this entry ID was first created. Replacing the entry preserves this value.

Error responses ​

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