Skip to content
Dashboard
API Reference

Get an Entry ​

Get one shared-store entry.

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

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 containing the requested entry.
entry_idstringYesExact 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
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
{
  "entry": {
    "entry_id": "0689B",
    "display_name": "Jordan Lee",
    "metadata": { "age": 31, "market": "Austin" },
    "created_at": "2026-08-03T20:00:00Z"
  }
}
FieldTypeMeaning and possible values
entryobjectThe complete store-scoped entry matching {entry_id}. The object always contains every field listed below.
entry.entry_idstringCaller-defined identifier, unique within the store. It exactly matches the stored ID addressed by {entry_id}.
entry.display_namestringCurrent human-readable entry label. Always non-empty.
entry.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.
entry.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 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.