List Entries
curl --request GET \
--url https://api.example.com/shared-stores/{store_id}/entriesimport requests
url = "https://api.example.com/shared-stores/{store_id}/entries"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/shared-stores/{store_id}/entries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/shared-stores/{store_id}/entries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/shared-stores/{store_id}/entries"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/shared-stores/{store_id}/entries")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/shared-stores/{store_id}/entries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyShared Stores
List Entries
List every entry in a shared store.
GET
/
shared-stores
/
{store_id}
/
entries
List Entries
curl --request GET \
--url https://api.example.com/shared-stores/{store_id}/entriesimport requests
url = "https://api.example.com/shared-stores/{store_id}/entries"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/shared-stores/{store_id}/entries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/shared-stores/{store_id}/entries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/shared-stores/{store_id}/entries"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/shared-stores/{store_id}/entries")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/shared-stores/{store_id}/entries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyThis 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.
This endpoint has no query parameters or JSON request body.
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. |
curl \
"https://api.mosaic.so/shared-stores/11111111-1111-4111-8111-111111111111/entries" \
-H "Authorization: Bearer mk_your_api_key"
Response
200 OK
{
"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. |
Was this page helpful?
⌘I