Retrieve items from one or more Collections in a single request, by passing a comma-delimited list of collection keys. This is the only way to fetch several collections’ items in one call; the per-collection GET /content/{collection_key}/ endpoint always returns exactly one collection.Legacy Endpoint: This is an older, lighter-weight endpoint. With two or more keys, the response has no pagination meta and all items for each key are returned. With exactly one key that names a collection, the request is handled by GET /content/{collection_key}/: the response includes meta (count, next_page, previous_page) and accepts the same page, page_size, order, preview and fields.<name> parameters.
Authorizations
readTokenAuthHeaderreadTokenAuthQuery
Authorization
string
header
required
Set the Authorization header to Token your_read_api_token.
Example: Authorization: Token abc123def456
Note: The header value includes the Token prefix. Authorization: Bearer ... is not accepted and returns 401.
You can access your API token from your settings page.
Query Parameters
keys
string
required
Comma-delimited list of Collection keys to retrieve. Every key must match an existing collection, or the request returns a 404.
auth_token
string
Your ButterCMS read API token
test
enum<integer>
default:0
Set to 1 to include draft/unpublished collection items (the alias used by this legacy endpoint; equivalent to preview=1 elsewhere).
Available options:
0,
1
locale
string
Set to the api slug of your configured locale (e.g. en or fr). When omitted, this query parameter will default to your organization's default locale.
Maximum string length: 10
Example:
"en"
levels
integer
default:2
Depth of relationship serialization.
Controls how many levels of referenced content to include:
1: Direct fields only, references as URIs
2: Direct fields + one level of references (default)
3-5: Deeper relationship traversal
Important: Higher levels increase response size. Maximum 10MB per response.
Valid range: 1-5 (inclusive). Values outside this range will be automatically capped.
Required range: 1 <= x <= 5
Response
Collections retrieved successfully. The data object is keyed by each requested collection key. For two or more keys there is no pagination meta and all items for each key are included; a single collection key returns the GET /content/{collection_key}/ shape, with meta.
data
object
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ButterCMS Docs","colors":{"primary":"#0505e5","light":"#5050ff","dark":"#0000a0"},"logo":{"light":"https://cdn.buttercms.com/nDD3LeMXQxiR9aJRpRLE","dark":"https://cdn.buttercms.com/nDD3LeMXQxiR9aJRpRLE","href":"https://buttercms.com"},"favicon":"https://mintcdn.com/buttercms/ADHjuou5Js2KRBnv/favicon.svg?fit=max\u0026auto=format\u0026n=ADHjuou5Js2KRBnv\u0026q=85\u0026s=719e07eca4e3b3446e3ba6621a6095f0","navbar":{"links":[{"href":"https://buttercms.com/sales/","label":"Request a Demo"}],"primary":{"type":"button","label":"Start for Free","href":"https://app.buttercms.com/join/"}},"seo":{"metatags":{"canonical":"https://buttercms.com/docs","robots":"noindex, nofollow"}},"integrations":{"gtm":{"tagId":"GTM-W7DPCL97"}},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"buttercms","hasAudioNarration":false,"actualSubdomain":"buttercms","customDomains":["buttercms.com"],"gitSource":{"type":"github","owner":"buttercms","repo":"buttercms","deployBranch":"master","contentDirectory":"unified-docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afd6c61c83bd67fa977217d","clientVersion":"0.0.4269","searchFilterCounts":[{"language":"default","tag":"Frameworks","count":79},{"language":"default","tag":"Build your app","count":74},{"language":"default","tag":"Create content","count":74},{"language":"default","tag":"API Reference","count":63},{"language":"default","tag":"Creating and editing content","count":24},{"language":"default","tag":"Core concepts","count":23},{"language":"default","tag":"Starter projects","count":21},{"language":"default","tag":"All starter projects","count":20},{"language":"default","tag":"Webhooks API","count":19},{"language":"default","tag":"How-to recipes","count":18}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".mermaid .node rect,.mermaid .node circle,.mermaid .node ellipse,.mermaid .node polygon{fill:#f0f4ff!important;stroke:#0505e5!important;stroke-width:2px!important}.mermaid .node .label,.mermaid .node text,.mermaid .nodeLabel{font-family:'Open Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif!important;fill:#000022!important;font-size:14px!important;font-weight:500!important}.mermaid .cluster rect{fill:#f8fafc!important;stroke:#5050ff!important;stroke-width:2px!important;rx:8px!important;ry:8px!important}.mermaid .cluster text,.mermaid .cluster .nodeLabel{fill:#0505e5!important;font-weight:600!important;font-size:15px!important}.mermaid .edgePath .path,.mermaid .flowchart-link{stroke:#5050ff!important;stroke-width:2px!important}.mermaid .arrowheadPath,.mermaid marker path{fill:#5050ff!important;stroke:#5050ff!important}.mermaid .edgeLabel,.mermaid .edgeLabel rect{background-color:#ffffff!important;fill:#ffffff!important}.mermaid .edgeLabel p,.mermaid .edgeLabel>p,.mermaid .edgeLabel div,.mermaid .edgeLabel>div{background:#f8fafc!important}.mermaid .edgeLabel text,.mermaid .edgeLabel .label{fill:#000022!important;font-size:12px!important}.mermaid .actor{fill:#f0f4ff!important;stroke:#0505e5!important;stroke-width:2px!important}.mermaid .actor-line{stroke:#5050ff!important;stroke-width:1px!important}.mermaid text.actor{fill:#000022!important;font-weight:600!important}.mermaid .messageText{fill:#000022!important;font-size:13px!important}.mermaid .messageLine0,.mermaid .messageLine1{stroke:#5050ff!important;stroke-width:1.5px!important}.mermaid .note{fill:#fbe700!important;stroke:#c4b800!important}.mermaid .noteText{fill:#000022!important}.mermaid .statediagram-state rect{fill:#f0f4ff!important;stroke:#0505e5!important;stroke-width:2px!important;rx:6px!important}.mermaid .state-start,.mermaid .state-end{fill:#0505e5!important}.mermaid .pieTitleText{fill:#0505e5!important;font-weight:600!important;font-size:16px!important}.mermaid .classGroup rect{fill:#f0f4ff!important;stroke:#0505e5!important}.mermaid .classGroup text{fill:#000022!important}.mermaid .er.entityBox{fill:#f0f4ff!important;stroke:#0505e5!important}.mermaid .section{fill:#f0f4ff!important}.mermaid .task{fill:#5050ff!important;stroke:#0505e5!important}.mermaid .taskText{fill:#ffffff!important}.mermaid,pre:has(.mermaid),div:has(>.mermaid){max-width:100%!important;min-width:100%!important;padding:1.5rem!important}.mermaid svg{width:100%!important;max-width:100%!important;height:auto!important;min-height:200px!important;max-height:800px!important}.dark .mermaid .edgeLabel p,.dark .mermaid .edgeLabel>p,.dark .mermaid .edgeLabel div,.dark .mermaid .edgeLabel>div{background:#1a1a2e!important}.dark .mermaid{background:#1a1a2e!important}.dark .mermaid .node rect,.dark .mermaid .node circle,.dark .mermaid .node ellipse{fill:#2a2a4a!important;stroke:#5050ff!important}.dark .mermaid .node text,.dark .mermaid .nodeLabel{fill:#e0e0e0!important}.dark .mermaid .cluster rect{fill:#1e1e3a!important;stroke:#5050ff!important}.dark .mermaid .cluster text{fill:#8080ff!important}.dark .mermaid .edgePath .path,.dark .mermaid .flowchart-link{stroke:#7070ff!important}.dark .mermaid .arrowheadPath{fill:#7070ff!important}.dark .mermaid .edgeLabel rect{fill:#1a1a2e!important}.dark .mermaid .edgeLabel text{fill:#e0e0e0!important}.diagram-modal-toggle{display:none}.diagram-container{position:relative}.diagram-preview{position:relative;display:block;cursor:zoom-in;transition:opacity 0.2s ease}.diagram-preview:hover{opacity:0.95}.diagram-expand-hint{position:absolute;top:12px;right:12px;background:rgba(255, 255, 255, 0.95);color:#0505e5;padding:6px 12px;border-radius:6px;font-size:12px;font-weight:500;opacity:0;transition:opacity 0.2s ease;pointer-events:none;box-shadow:0 2px 8px rgba(0, 0, 0, 0.15);z-index:10}.diagram-preview:hover .diagram-expand-hint{opacity:1}.dark .diagram-expand-hint{background:rgba(30, 30, 46, 0.95);color:#8080ff}.diagram-modal-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0, 0, 0, 0.9);display:none;align-items:center;justify-content:center;z-index:9999;padding:2rem;cursor:zoom-out}.diagram-modal-toggle:checked~.diagram-modal-overlay{display:flex;animation:fadeIn 0.2s ease}.diagram-modal-content{max-width:90vw;max-height:90vh;background:#ffffff;border-radius:12px;padding:2rem;box-shadow:0 20px 60px rgba(0, 0, 0, 0.5);cursor:default;overflow:auto}.dark .diagram-modal-content{background:#1a1a2e}.diagram-modal-toggle:checked~*{overflow:hidden}.mermaid-lightbox-wrapper{position:relative;cursor:zoom-in;transition:all 0.2s ease}.mermaid-lightbox-wrapper:hover{opacity:0.95}.mermaid-expand-icon{position:absolute;top:12px;right:12px;width:32px;height:32px;display:flex;align-items:center;justify-content:center;background:rgba(255, 255, 255, 0.95);border-radius:6px;box-shadow:0 2px 8px rgba(0, 0, 0, 0.15);opacity:0;transition:opacity 0.2s ease, transform 0.2s ease;pointer-events:none;z-index:10}.mermaid-lightbox-wrapper:hover .mermaid-expand-icon{opacity:1;transform:scale(1.05)}.mermaid-expand-icon svg{width:18px;height:18px;color:#0505e5}.dark .mermaid-expand-icon{background:rgba(30, 30, 46, 0.95)}.dark .mermaid-expand-icon svg{color:#8080ff}.mermaid-lightbox-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0, 0, 0, 0.9);display:flex;align-items:center;justify-content:center;z-index:9999;padding:2rem;animation:fadeIn 0.2s ease;cursor:zoom-out}@keyframes fadeIn{from{opacity:0}to{opacity:1}}.mermaid-lightbox-content{max-width:90vw;max-height:90vh;background:#ffffff;border-radius:12px;padding:2rem;box-shadow:0 20px 60px rgba(0, 0, 0, 0.5);cursor:default;overflow:auto}.dark .mermaid-lightbox-content{background:#1a1a2e}.mermaid-lightbox-content .mermaid{padding:0!important}.mermaid-lightbox-content .mermaid svg{max-height:85vh!important;width:auto!important;max-width:85vw!important}.mermaid-lightbox-close{position:fixed;top:1.5rem;right:1.5rem;width:48px;height:48px;display:flex;align-items:center;justify-content:center;background:rgba(255, 255, 255, 0.95);border:none;border-radius:50%;cursor:pointer;box-shadow:0 4px 12px rgba(0, 0, 0, 0.3);transition:all 0.2s ease;z-index:10000}.mermaid-lightbox-close:hover{transform:scale(1.1);background:#ffffff}.mermaid-lightbox-close svg{width:24px;height:24px;color:#000022}.dark .mermaid-lightbox-close{background:rgba(30, 30, 46, 0.95)}.dark .mermaid-lightbox-close:hover{background:#1e1e3a}.dark .mermaid-lightbox-close svg{color:#e0e0e0}.mermaid-scroll-zoom{overflow:auto;max-height:500px;border:1px solid #e5e7eb;border-radius:12px;background:#ffffff;margin:1rem 0;cursor:grab;position:relative}.mermaid-scroll-zoom:active{cursor:grabbing}.dark .mermaid-scroll-zoom{border-color:#374151;background:#1a1a2e}.mermaid-scroll-zoom .mermaid{padding:1.5rem!important;min-width:100%;width:max-content}.mermaid-scroll-zoom .mermaid svg{min-width:120%;max-width:none!important;max-height:none!important;height:auto!important;transform-origin:top left}.mermaid-zoom-hint{text-align:center;font-size:12px;color:#6b7280;margin:0.5rem 0 1rem 0;font-style:italic}.dark .mermaid-zoom-hint{color:#9ca3af}.mermaid-scroll-zoom::-webkit-scrollbar{width:8px;height:8px}.mermaid-scroll-zoom::-webkit-scrollbar-track{background:#f1f1f1;border-radius:4px}.mermaid-scroll-zoom::-webkit-scrollbar-thumb{background:#c1c1c1;border-radius:4px}.mermaid-scroll-zoom::-webkit-scrollbar-thumb:hover{background:#a1a1a1}.dark .mermaid-scroll-zoom::-webkit-scrollbar-track{background:#2a2a4a}.dark .mermaid-scroll-zoom::-webkit-scrollbar-thumb{background:#4a4a6a}.dark .mermaid-scroll-zoom::-webkit-scrollbar-thumb:hover{background:#5a5a7a}@media (max-width: 768px){.mermaid-lightbox-overlay{padding:1rem}.mermaid-lightbox-content{max-width:95vw;max-height:95vh;padding:1rem}.mermaid-lightbox-content .mermaid svg{max-height:90vh!important;max-width:90vw!important}.mermaid-lightbox-close{width:40px;height:40px;top:1rem;right:1rem}.mermaid-lightbox-close svg{width:20px;height:20px}.mermaid-expand-icon{opacity:0.8}}"}]}
{"page":{"pagePath":"api-reference/collections/retrieve-multiple-collections-by-key","slug":"/api-reference/collections/retrieve-multiple-collections-by-key","pageMetadata":{"title":"Retrieve Multiple Collections by Key","description":"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/","href":"/api-reference/collections/retrieve-multiple-collections-by-key","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Retrieve items from one or more Collections in a single request, by passing a comma-delimited list of collection keys. This is the only way to fetch several collections’ items in one call; the per-collection `,_jsx(_components.code,{children:`GET /content/{collection_key}/`}),` endpoint always returns exactly one collection.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Legacy Endpoint`}),`: This is an older, lighter-weight endpoint. With two or more keys, the response has no pagination `,_jsx(_components.code,{children:`meta`}),` and all items for each key are returned. With exactly one key that names a collection, the request is handled by `,_jsx(_components.code,{children:`GET /content/{collection_key}/`}),`: the response includes `,_jsx(_components.code,{children:`meta`}),` (`,_jsx(_components.code,{children:`count`}),`, `,_jsx(_components.code,{children:`next_page`}),`, `,_jsx(_components.code,{children:`previous_page`}),`) and accepts the same `,_jsx(_components.code,{children:`page`}),`, `,_jsx(_components.code,{children:`page_size`}),`, `,_jsx(_components.code,{children:`order`}),`, `,_jsx(_components.code,{children:`preview`}),` and `,_jsx(_components.code,{children:`fields.\u003cname>`}),` parameters.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve Multiple Collections by Key","description":"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/","href":"/api-reference/collections/retrieve-multiple-collections-by-key","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Collections"],"summary":"Retrieve Multiple Collections by Key","description":"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.","x-mint":{"metadata":{"description":"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys."},"content":"Retrieve items from one or more Collections in a single request, by passing a comma-delimited list of collection keys. This is the only way to fetch several collections' items in one call; the per-collection `GET /content/{collection_key}/` endpoint always returns exactly one collection.\n\n**Legacy Endpoint**: This is an older, lighter-weight endpoint. With two or more keys, the response has no pagination `meta` and all items for each key are returned. With exactly one key that names a collection, the request is handled by `GET /content/{collection_key}/`: the response includes `meta` (`count`, `next_page`, `previous_page`) and accepts the same `page`, `page_size`, `order`, `preview` and `fields.\u003cname>` parameters.\n"},"operationId":"retrieveCollectionsByKeys","security":["ebce0957-e857-46b5-8db4-33e76c6447e3","1da7e986-7c52-4b8d-81b6-c43bbc79c9a2"],"parameters":["ff7823ba-ab29-4b39-b456-5dfb50fe26b2","d50f7f8f-e647-4959-a2f3-a7ee106b9b3e","41ceaffe-f232-476e-8d07-68e6053a24f3","e3115351-1a4e-4ac0-af23-77516617677d","44cc4f84-3e5e-4e21-bc3f-ff84162541e7"],"responses":{"200":"eb03f171-aa50-42dc-92e1-24c960b1526c","401":"727f7c42-c329-438f-ae3c-ec5d76982fb8","404":"fa37f959-f62a-4e15-8043-220efd764462"},"method":"get","type":"path","servers":["5245510f-95b6-4fd0-b4e8-4159dcc1f97b"],"path":"/content/","baseUrlOptions":["https://api.buttercms.com/v2"],"title":"Retrieve Multiple Collections by Key","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ff7823ba-ab29-4b39-b456-5dfb50fe26b2":{"name":"keys","in":"query","required":true,"schema":{"type":"string","isRequired":true,"description":"Comma-delimited list of Collection keys to retrieve. Every key must match an existing collection, or the request returns a `404`.\n","uniqueKey":"","typeLabel":"string"},"description":"Comma-delimited list of Collection keys to retrieve. Every key must match an existing collection, or the request returns a `404`.\n","example":"navigation_menu_item,navigation_menu"},"d50f7f8f-e647-4959-a2f3-a7ee106b9b3e":{"name":"auth_token","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Your ButterCMS read API token\n","uniqueKey":"","typeLabel":"string"},"description":"Your ButterCMS read API token\n","example":"your_api_token"},"41ceaffe-f232-476e-8d07-68e6053a24f3":{"name":"test","in":"query","description":"Set to 1 to include draft/unpublished collection items (the alias used by this legacy endpoint; equivalent to `preview=1` elsewhere).\n","required":false,"schema":{"type":"integer","enum":[0,1],"default":0,"isRequired":false,"description":"Set to 1 to include draft/unpublished collection items (the alias used by this legacy endpoint; equivalent to `preview=1` elsewhere).\n","uniqueKey":"","typeLabel":"enum\u003cinteger>"}},"e3115351-1a4e-4ac0-af23-77516617677d":{"name":"locale","in":"query","description":"Set to the api slug of your configured locale (e.g. `en` or `fr`). When omitted, this query parameter will default to your organization's default locale.\n","required":false,"schema":{"type":"string","maxLength":10,"example":"en","isRequired":false,"description":"Set to the api slug of your configured locale (e.g. `en` or `fr`). When omitted, this query parameter will default to your organization's default locale.\n","uniqueKey":"","typeLabel":"string"},"examples":{"english":{"value":"en","description":"English locale"},"spanish":{"value":"es","description":"Spanish locale"},"french":{"value":"fr","description":"French locale"}}},"44cc4f84-3e5e-4e21-bc3f-ff84162541e7":{"name":"levels","in":"query","description":"Depth of relationship serialization.\n\nControls how many levels of referenced content to include:\n- **1**: Direct fields only, references as URIs\n- **2**: Direct fields + one level of references (default)\n- **3-5**: Deeper relationship traversal\n\n**Important**: Higher levels increase response size. Maximum 10MB per response.\n\nValid range: 1-5 (inclusive). Values outside this range will be automatically capped.\n","required":false,"schema":{"type":"integer","minimum":1,"maximum":5,"default":2,"isRequired":false,"description":"Depth of relationship serialization.\n\nControls how many levels of referenced content to include:\n- **1**: Direct fields only, references as URIs\n- **2**: Direct fields + one level of references (default)\n- **3-5**: Deeper relationship traversal\n\n**Important**: Higher levels increase response size. Maximum 10MB per response.\n\nValid range: 1-5 (inclusive). Values outside this range will be automatically capped.\n","uniqueKey":"","typeLabel":"integer"},"examples":{"shallow":{"value":1,"description":"Minimal depth (1 level)"},"default":{"value":2,"description":"Default depth (2 levels)"},"deep":{"value":5,"description":"Maximum depth (5 levels)"}}}},"responses":{"eb03f171-aa50-42dc-92e1-24c960b1526c":{"description":"Collections retrieved successfully. The `data` object is keyed by each requested collection key. For two or more keys there is no pagination `meta` and all items for each key are included; a single collection key returns the `GET /content/{collection_key}/` shape, with `meta`.\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","description":"Individual collection item with dynamic field structure and metadata","properties":{"meta":{"type":"object","description":"Metadata for collection items containing unique identifier","properties":{"id":{"type":"integer","description":"Unique identifier for the collection item, used for updates and deletions","example":123,"isRequired":true,"uniqueKey":"data.additionalProperties.items.[INDEX].meta.id","typeLabel":"integer"}},"required":["id"],"uniqueKey":"data.additionalProperties.items.[INDEX].meta","typeLabel":"object"}},"additionalProperties":true,"example":{"meta":{"id":123},"name":"The Beatles","genre":"Rock","formed_year":1960,"members":["John Lennon","Paul McCartney","George Harrison","Ringo Starr"],"description":"Legendary British rock band"},"uniqueKey":"data.additionalProperties.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.additionalProperties","typeLabel":"object[]"},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"multiple_collections":{"title":"multiple_collections","summary":"Two collections in one request","value":{"data":{"navigation_menu_item":[{"meta":{"id":790691},"label":"Home","url":"#home"},{"meta":{"id":790692},"label":"About","url":"#about"}],"navigation_menu":[{"meta":{"id":790697},"name":"Main menu","menu_items":[{"meta":{"id":790691},"label":"Home","url":"#home"},{"meta":{"id":790692},"label":"About","url":"#about"}]}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"727f7c42-c329-438f-ae3c-ec5d76982fb8":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Error message describing what went wrong","example":"Authentication credentials were not provided.","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing_token":{"title":"missing_token","summary":"Missing API token (most Read endpoints)","description":"The message most Read API endpoints (Pages, Blog Posts, Blog metadata, Feeds, `/v2/content/?keys=` and single collection items) return for a missing token.","value":{"detail":"Incorrect authentication credentials."}},"missing_token_collections":{"title":"missing_token_collections","summary":"Missing API token (writes, collection by key, page search)","description":"Write requests, `GET /v2/content/{key}/` and `GET /v2/pages/search/` return this message instead for a missing token.","value":{"detail":"Authentication credentials were not provided."}},"invalid_token":{"title":"invalid_token","summary":"Invalid API token","value":{"detail":"Invalid token."}}},"exampleType":"examples"}},"exampleType":"examples"},"fa37f959-f62a-4e15-8043-220efd764462":{"description":"**Not Found - Unknown Collection Key**\n\nAt least one of the keys in `keys` does not match any collection configured for your organization.\n","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Error message describing what went wrong","example":"Authentication credentials were not provided.","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":"Content key bogus_key not found"},"examples":{"Example":{"title":"Example","value":{"detail":"Content key bogus_key not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"ebce0957-e857-46b5-8db4-33e76c6447e3":{"readTokenAuthHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Set the `Authorization` header to `Token your_read_api_token`.\n\nExample: `Authorization: Token abc123def456`\n\nNote: The header value includes the `Token` prefix. `Authorization: Bearer ...` is not accepted and returns 401.\n\nYou can access your API token from your settings page.\n","scopes":[],"schemeName":"readTokenAuthHeader"}},"1da7e986-7c52-4b8d-81b6-c43bbc79c9a2":{"readTokenAuthQuery":{"type":"apiKey","in":"query","name":"auth_token","description":"Pass your API token via the `auth_token` parameter on every request: `?auth_token=your_read_api_token`.\n\nYou can access your API token from your settings page.\n\nRequests made with a missing or invalid token will get a 401 Unauthorized response. All requests must be made over HTTPS.\n","scopes":[],"schemeName":"readTokenAuthQuery"}}},"servers":{"5245510f-95b6-4fd0-b4e8-4159dcc1f97b":{"url":"https://api.buttercms.com/v2","description":"ButterCMS API v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Set the `Authorization` header to `Token your_read_api_token`.\n\nExample: `Authorization: Token abc123def456`\n\nNote: The header value includes the `Token` prefix. `Authorization: Bearer ...` is not accepted and returns 401.\n\nYou can access your API token from your settings page.\n","scopes":[],"schemeName":"readTokenAuthHeader"},"schema":{"title":"Authorization","type":"string","description":"Set the `Authorization` header to `Token your_read_api_token`.\n\nExample: `Authorization: Token abc123def456`\n\nNote: The header value includes the `Token` prefix. `Authorization: Bearer ...` is not accepted and returns 401.\n\nYou can access your API token from your settings page.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"readTokenAuthHeader","name":"Authorization"}],"title":"readTokenAuthHeader"},{"schemes":[{"scheme":{"type":"apiKey","in":"query","name":"auth_token","description":"Pass your API token via the `auth_token` parameter on every request: `?auth_token=your_read_api_token`.\n\nYou can access your API token from your settings page.\n\nRequests made with a missing or invalid token will get a 401 Unauthorized response. All requests must be made over HTTPS.\n","scopes":[],"schemeName":"readTokenAuthQuery"},"schema":{"title":"auth_token","type":"string","description":"Pass your API token via the `auth_token` parameter on every request: `?auth_token=your_read_api_token`.\n\nYou can access your API token from your settings page.\n\nRequests made with a missing or invalid token will get a 401 Unauthorized response. All requests must be made over HTTPS.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"readTokenAuthQuery","name":"auth_token"}],"title":"readTokenAuthQuery"}]},"originalFileLocation":"api/openapi/read_api.yaml"},"subdomain":"buttercms","siteName":"ButterCMS Docs","title":"Retrieve Multiple Collections by Key - ButterCMS Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T14:11:45.716Z","originalFileLocation":"api-reference/collections/retrieve-multiple-collections-by-key.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ButterCMS Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex, nofollow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve Multiple Collections by Key - ButterCMS Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ButterCMS Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://buttercms.mintlify.site/docs/_mintlify/api/og/v2?division=Collections\u0026amp;title=Retrieve+Multiple+Collections+by+Key\u0026amp;description=Retrieve+items+from+one+or+more+Collections+at+once%2C+by+a+comma-delimited+list+of+collection+keys.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=2adce90473e40ffc2feb83690d482cbbc1210e0a8e79bfa4dba83bc0045fa620\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retrieve Multiple Collections by Key - ButterCMS Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://buttercms.mintlify.site/docs/_mintlify/api/og/v2?division=Collections\u0026amp;title=Retrieve+Multiple+Collections+by+Key\u0026amp;description=Retrieve+items+from+one+or+more+Collections+at+once%2C+by+a+comma-delimited+list+of+collection+keys.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=2adce90473e40ffc2feb83690d482cbbc1210e0a8e79bfa4dba83bc0045fa620\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ButterCMS Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0505e5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/collections/retrieve-multiple-collections-by-key.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://buttercms.com/#organization\",\"name\":\"ButterCMS Docs\",\"url\":\"https://buttercms.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://cdn.buttercms.com/nDD3LeMXQxiR9aJRpRLE\"}},{\"@type\":\"WebSite\",\"@id\":\"https://buttercms.com/docs#website\",\"name\":\"ButterCMS Docs\",\"url\":\"https://buttercms.com/docs\",\"publisher\":{\"@id\":\"https://buttercms.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key#webpage\",\"url\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key\",\"name\":\"Retrieve Multiple Collections by Key\",\"description\":\"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.\",\"dateModified\":\"2026-10-27T14:11:45.716Z\",\"isPartOf\":{\"@id\":\"https://buttercms.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Read API\",\"item\":\"https://buttercms.com/docs/api-reference/pages/get-multiple-pages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve Multiple Collections by Key\",\"item\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key#apireference\",\"headline\":\"Retrieve Multiple Collections by Key\",\"name\":\"Retrieve Multiple Collections by Key\",\"description\":\"Retrieve items from one or more Collections at once, by a comma-delimited list of collection keys.\",\"url\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key\",\"mainEntityOfPage\":{\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key#webpage\"},\"dateModified\":\"2026-10-27T14:11:45.716Z\",\"publisher\":{\"@id\":\"https://buttercms.com/#organization\"},\"isPartOf\":{\"@id\":\"https://buttercms.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ButterCMS Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ButterCMS Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/collections/retrieve-multiple-collections-by-key.md","siteName":"ButterCMS Docs","nav":{"global":null,"tabs":[{"tab":"Quickstart","pages":[{"title":"Quickstart","href":""}]},{"tab":"Core concepts","pages":[{"title":"Core concepts","href":"/core-concepts/content-types/overview"}]},{"tab":"Create content","pages":[{"title":"Create content","href":"/create-content/overview"}]},{"tab":"Build your app","pages":[{"title":"Build your app","href":"/build-your-app/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API overview","icon":"code","href":"/api/overview"},{"title":"API architecture \u0026 principles","icon":"sitemap","href":"/api/concepts/api-architecture-principles"},{"title":"Authentication \u0026 API tokens","icon":"key","href":"/api/concepts/authentication-api-tokens"},{"title":"Request/response format","icon":"code","href":"/api/concepts/request-response-format"},{"title":"REST endpoints \u0026 URLs","icon":"route","href":"/api/concepts/rest-endpoints-urls"},{"title":"HTTP status codes \u0026 errors","icon":"triangle-exclamation","href":"/api/concepts/http-status-codes-errors"},{"title":"Rate limits \u0026 throttling","icon":"gauge-high","href":"/api/concepts/rate-limits-throttling"},{"title":"Bulk Operations","icon":"layer-group","href":"/api/concepts/bulk-operations"},{"title":"Pages: key concepts","icon":"file","href":"/api/concepts/pages-key-concepts"},{"title":"Components: key concepts","icon":"layer-group","href":"/api/concepts/pages-components"},{"title":"Collections: key concepts","icon":"table","href":"/api/concepts/collections-key-concepts"},{"title":"Blog Posts: key concepts","icon":"newspaper","href":"/api/concepts/blog-posts-key-concepts"},{"title":"Webhooks: key concepts","icon":"bell","href":"/api/concepts/webhooks-overview"}]},{"group":"Read API","expanded":true,"pages":[{"group":"Pages","pages":[{"title":"Get multiple Pages","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /pages/{page_type}/","href":"/api-reference/pages/get-multiple-pages"},{"title":"Get a single Page","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /pages/{page_type}/{page_slug}/","href":"/api-reference/pages/get-a-single-page"},{"title":"Search Pages","description":"Search for pages using a text query. Results are sorted by relevance and can be filtered by page type.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /pages/search/","href":"/api-reference/pages/search-pages"}]},{"group":"Collections","pages":[{"title":"Retrieve Multiple Collections by Key","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/","href":"/api-reference/collections/retrieve-multiple-collections-by-key"},{"title":"Retrieve Collection","description":"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/{collection_key}/","href":"/api-reference/collections/retrieve-collection"},{"title":"Retrieve Collection Item","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/{collection_key}/{item_id}/","href":"/api-reference/collections/retrieve-collection-item"}]},{"group":"Blog posts","pages":[{"title":"List All Posts","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/","href":"/api-reference/blog-posts/list-all-posts"},{"title":"Retrieve Single Post","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/{slug}/","href":"/api-reference/blog-posts/retrieve-single-post"},{"title":"Search Posts","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/search/","href":"/api-reference/blog-posts/search-posts"}]},{"group":"Blog metadata","pages":[{"title":"List All Authors","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /authors/","href":"/api-reference/blog-metadata/list-all-authors"},{"title":"Retrieve Author","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /authors/{slug}/","href":"/api-reference/blog-metadata/retrieve-author"},{"title":"List All Categories","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /categories/","href":"/api-reference/blog-metadata/list-all-categories"},{"title":"Retrieve Category","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /categories/{slug}/","href":"/api-reference/blog-metadata/retrieve-category"},{"title":"List All Tags","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /tags/","href":"/api-reference/blog-metadata/list-all-tags"},{"title":"Retrieve Tag","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /tags/{slug}/","href":"/api-reference/blog-metadata/retrieve-tag"}]},{"group":"Feeds and utilities","pages":[{"title":"RSS Feed","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /feeds/rss/","href":"/api-reference/feeds-and-utilities/rss-feed"},{"title":"Atom Feed","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /feeds/atom/","href":"/api-reference/feeds-and-utilities/atom-feed"},{"title":"Sitemap","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /feeds/sitemap/","href":"/api-reference/feeds-and-utilities/sitemap"}]}]},{"group":"Write API","expanded":true,"pages":[{"group":"Pages","pages":[{"title":"Create Page via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml post /pages/","href":"/api-reference/pages/create-page-via-write-api"},{"title":"Update Page via Write API (PUT)","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml put /pages/{page_type}/{page_slug}/","href":"/api-reference/pages/update-page-via-write-api-put"},{"title":"Update Page via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml patch /pages/{page_type}/{page_slug}/","href":"/api-reference/pages/update-page-via-write-api"}]},{"group":"Collections","pages":[{"title":"Create Collection Item","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml post /content/","href":"/api-reference/collections/create-collection-item"},{"title":"Update Collection Item (Full)","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml put /content/{collection_key}/{item_id}/","href":"/api-reference/collections/update-collection-item-full"},{"title":"Delete Collection Item","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml delete /content/{collection_key}/{item_id}/","href":"/api-reference/collections/delete-collection-item"},{"title":"Update Collection Item (Partial)","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml patch /content/{collection_key}/{item_id}/","href":"/api-reference/collections/update-collection-item-partial"}]},{"group":"Blog posts","pages":[{"title":"Create Blog Post via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml post /posts/","href":"/api-reference/blog-posts/create-blog-post-via-write-api"},{"title":"Delete Blog Post via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml delete /posts/{slug}/","href":"/api-reference/blog-posts/delete-blog-post-via-write-api"},{"title":"Update Blog Post via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml patch /posts/{slug}/","href":"/api-reference/blog-posts/update-blog-post-via-write-api"}]}]},{"group":"Webhooks API","expanded":true,"pages":[{"group":"Page events","pages":[{"title":"Page published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-published","href":"/api-reference/page-events/page-published"},{"title":"Page draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-draft-saved","href":"/api-reference/page-events/page-draft-saved"},{"title":"Page unpublished","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-unpublished","href":"/api-reference/page-events/page-unpublished"},{"title":"Page deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-deleted","href":"/api-reference/page-events/page-deleted"},{"title":"Page any activity","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-any-activity","href":"/api-reference/page-events/page-any-activity"}]},{"group":"Post events","pages":[{"title":"Blog post published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-published","href":"/api-reference/post-events/blog-post-published"},{"title":"Blog post draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-draft-saved","href":"/api-reference/post-events/blog-post-draft-saved"},{"title":"Blog post deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-deleted","href":"/api-reference/post-events/blog-post-deleted"},{"title":"Blog post any activity","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-any-activity","href":"/api-reference/post-events/blog-post-any-activity"},{"title":"Localized blog post published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-locale-published","href":"/api-reference/post-events/localized-blog-post-published"},{"title":"Localized blog post draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-locale-draft-saved","href":"/api-reference/post-events/localized-blog-post-draft-saved"},{"title":"Localized blog post deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-locale-deleted","href":"/api-reference/post-events/localized-blog-post-deleted"}]},{"group":"Collection events","pages":[{"title":"Collection item published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-published","href":"/api-reference/collection-events/collection-item-published"},{"title":"Collection item draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-draft-saved","href":"/api-reference/collection-events/collection-item-draft-saved"},{"title":"Collection item unpublished","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-unpublished","href":"/api-reference/collection-events/collection-item-unpublished"},{"title":"Collection item deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-deleted","href":"/api-reference/collection-events/collection-item-deleted"},{"title":"Collection item any activity","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-any-activity","href":"/api-reference/collection-events/collection-item-any-activity"}]},{"group":"Media events","pages":[{"title":"Media video uploaded","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook media-video-uploaded","href":"/api-reference/media-events/media-video-uploaded"},{"title":"Media updated","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook media-updated","href":"/api-reference/media-events/media-updated"}]}]},{"group":"Image API","pages":[{"title":"Image transformations","icon":"wand-magic-sparkles","href":"/api/image-api/image-transformations"},{"title":"Responsive images","icon":"mobile","href":"/api/image-api/responsive-images"},{"title":"Security \u0026 authentication","icon":"shield","href":"/api/image-api/security-authentication"}]}]},{"tab":"Frameworks","pages":[{"title":"Frameworks","href":"/frameworks/tab-overview"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support/account-management/account-settings"}]}]},"basePath":"","title":"Retrieve Multiple Collections by Key - ButterCMS Docs","deploymentId":"dpl_6vPoC2SUh9GmkFA893PjMxRhqDMH","buildId":"dpl_6vPoC2SUh9GmkFA893PjMxRhqDMH","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-u5VM7GbL.js","snippetPresets-DpRtxfzN.js","utils-4WY8xT40.js","style-to-object-BY3JEAdk.js","utils-BlgoC-Za.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DDAbSLSO.js","conditional-requirements-CFM0id0Q.js","cloneDeep-BCc563vu.js","_Uint8Array-C9shTgNp.js","isObject-FP1Yky1u.js","ApiExamples-uOsNtQQQ.js","usePlaygroundInputsStore-Dq4MAtId.js","shallow-BmlLceyU.js","isEqual--GWG4bUI.js","CodeSnippets-C8Drf_RB.js","CodeSnippet-uwyahond.js","getApiPlaygroundDisplay-TQR-RdV-.js","Page-siaPhyVT.js","DynamicMarkdown-DaMPtKqa.js","SectionHeading-DAwE4xE4.js","icon-DDxg2Itp.js","MethodPill-ibpzSfFB.js","getPastedJson-DH7I_Tl-.js","Check2Icon-WCbeCmeN.js","axios-CsQoIw0U.js","Markdown-DDO7Rx0T.js","AssistantPageLink-BIkzsLc2.js","dist-7QbhZ_yL.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}