{ "meta": { "count": 25, "next_page": 3, "previous_page": 1 }, "data": { "artists": [ { "meta": { "id": 123 }, "name": "The Beatles", "genre": "Rock", "formed_year": 1960, "description": "Legendary British rock band" }, { "meta": { "id": 124 }, "name": "The Rolling Stones", "genre": "Rock", "formed_year": 1962, "description": "Iconic rock and roll band" } ] }}
Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization capabilities. This endpoint provides flexible access to your dynamic content with powerful query options.Collection Structure: Collections contain completely user-defined content with customizable field schemas that you configure through the dashboard. Each collection can have different field types, validation rules, and structural requirements based on your content needs.Response Format: The response includes a meta object containing pagination information and result counts, a data array with the actual collection items, and individual item.meta objects containing unique IDs that you’ll need for update and delete operations.
See also: Architecture & Performance for guidance on levels, pagination, and performance best practices.
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.
Path Parameters
collection_key
string
required
The unique identifier/slug of the Collection to retrieve.
Must match an existing collection in your organization.
Maximum string length: 50
Query Parameters
auth_token
string
Your ButterCMS read API token
preview
enum<integer>
default:0
Set to 1 to include draft/unpublished collection items. Useful for staging environments.
Alias: test=1 is also accepted and has the same effect.
Available options:
0,
1
test
enum<integer>
default:0
Legacy alias for preview. Set to 1 to include draft/unpublished collection items.
Available options:
0,
1
order
string
Order items by one of this Collection's own field keys (optionally prefixed with - for descending). The value must match a field actually defined on the Collection's schema. Pages-style meta keys like published/updated are not valid here and return a 403.
When omitted, items are returned in natural (insertion) order.
page
integer
default:1
Page number for page-based pagination.
Mutually exclusive with limit/offset parameters.
Required range: x >= 1
page_size
integer
default:10
Number of items per page for page-based pagination.
Mutually exclusive with limit/offset parameters.
Required range: 1 <= x <= 100
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
alt_media_text
enum<integer>
default:0
Media field response format.
Affects only media-typed fields. Other field types are unchanged.
0 (default): Media fields return simple URL strings
1: Media fields return objects with at least url and, when available,
alt. If the stored media value is just a URL string, the object will
include url only.
Available options:
0,
1
fields
object
Dynamic field filtering using individual fields.<field_name>=<value> query parameters (not an OpenAPI deepObject-style parameter).
Filter collection items by any field using the pattern fields.{field_name}=value:
fields.genre=Rock - Filter by genre field
fields.status=published - Filter by status field
fields.year=2023 - Filter by year field
Multiple field filters can be combined in a single request.
Show child attributes
Response
Collection retrieved successfully
Collection response using page-based pagination
meta
object
required
Pagination metadata for collection retrieval
Show child attributes
data
object
required
Collection data object with dynamic key based on collection name
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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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-collection","slug":"/api-reference/collections/retrieve-collection","pageMetadata":{"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","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 a specific Collection with comprehensive filtering, pagination, and relationship serialization.\"\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:[_jsx(_components.p,{children:`Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization capabilities. This endpoint provides flexible access to your dynamic content with powerful query options.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Collection Structure`}),`: Collections contain completely user-defined content with customizable field schemas that you configure through the dashboard. Each collection can have different field types, validation rules, and structural requirements based on your content needs.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Response Format`}),`: The response includes a `,_jsx(_components.code,{children:`meta`}),` object containing pagination information and result counts, a `,_jsx(_components.code,{children:`data`}),` array with the actual collection items, and individual `,_jsx(_components.code,{children:`item.meta`}),` objects containing unique IDs that you’ll need for update and delete operations.\nSee also: Architecture \u0026 Performance for guidance on `,_jsx(_components.code,{children:`levels`}),`, pagination, and performance best practices.`]})]})}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 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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Collections"],"summary":"Retrieve Collection","description":"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization.","x-mint":{"metadata":{"description":"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization."},"content":"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization capabilities. This endpoint provides flexible access to your dynamic content with powerful query options.\n\n**Collection Structure**: Collections contain completely user-defined content with customizable field schemas that you configure through the dashboard. Each collection can have different field types, validation rules, and structural requirements based on your content needs.\n\n**Response Format**: The response includes a `meta` object containing pagination information and result counts, a `data` array with the actual collection items, and individual `item.meta` objects containing unique IDs that you'll need for update and delete operations.\nSee also: Architecture \u0026 Performance for guidance on `levels`, pagination, and performance best practices.\n"},"operationId":"retrieveCollection","parameters":["79424ff8-00aa-47df-8365-83ab3d7964b8","ef217ea1-65a7-4c64-bed9-5ce9987b1e77","a3cec527-01d3-4bc6-91c6-9f711af90901","5126eaab-79b7-43a4-87bd-df021e5c8ab3","feceb0d4-cfb9-43a6-baaf-79e5b7b14c9f","92aecba6-4b79-4200-9d3c-e312d3a55076","491a13d9-5381-4b9c-a599-0cb614532cd3","c86d25f8-33af-4746-a91b-30c9a618c390","6ca4b44e-2fbb-478d-93fc-331a8082fb88","0176d3d5-e2f0-4030-b617-5a2107fb8215","65c41ad0-c218-4aeb-9af5-4bd3c8999db3"],"responses":{"200":"cd8e059f-601f-4beb-91c6-036699b0859a","400":"1705006c-b2af-4dcd-b268-895f97b9fdec","401":"e466ecab-c7be-4c0e-b2c6-4f9b98476157","403":"3647d949-9351-45ef-a58a-d56ff3804456","404":"68b7b71f-bd90-4e11-a7c8-baabe0052f7c"},"security":["977db969-ad01-4a6e-a793-fc906be8097c","e629a3d1-ef7d-4cb3-889d-3dd712f1aa7c"],"method":"get","type":"path","servers":["5245510f-95b6-4fd0-b4e8-4159dcc1f97b"],"path":"/content/{collection_key}/","baseUrlOptions":["https://api.buttercms.com/v2"],"title":"Retrieve Collection","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"79424ff8-00aa-47df-8365-83ab3d7964b8":{"name":"collection_key","in":"path","required":true,"schema":{"type":"string","maxLength":50,"isRequired":true,"description":"The unique identifier/slug of the Collection to retrieve.\n\nMust match an existing collection in your organization.\n","uniqueKey":"","typeLabel":"string"},"description":"The unique identifier/slug of the Collection to retrieve.\n\nMust match an existing collection in your organization.\n","example":"artists"},"ef217ea1-65a7-4c64-bed9-5ce9987b1e77":{"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"},"a3cec527-01d3-4bc6-91c6-9f711af90901":{"name":"preview","in":"query","description":"Set to 1 to include draft/unpublished collection items. Useful for staging environments.\n\n**Alias**: `test=1` is also accepted and has the same effect.\n","required":false,"schema":{"type":"integer","enum":[0,1],"default":0,"isRequired":false,"description":"Set to 1 to include draft/unpublished collection items. Useful for staging environments.\n\n**Alias**: `test=1` is also accepted and has the same effect.\n","uniqueKey":"","typeLabel":"enum\u003cinteger>"},"example":1},"5126eaab-79b7-43a4-87bd-df021e5c8ab3":{"name":"test","in":"query","description":"Legacy alias for `preview`. Set to 1 to include draft/unpublished collection items.\n","required":false,"schema":{"type":"integer","enum":[0,1],"default":0,"isRequired":false,"description":"Legacy alias for `preview`. Set to 1 to include draft/unpublished collection items.\n","uniqueKey":"","typeLabel":"enum\u003cinteger>"}},"feceb0d4-cfb9-43a6-baaf-79e5b7b14c9f":{"name":"order","in":"query","description":"Order items by one of this Collection's own field keys (optionally prefixed with `-` for descending). The value must match a field actually defined on the Collection's schema. Pages-style meta keys like `published`/`updated` are not valid here and return a `403`.\n\nWhen omitted, items are returned in natural (insertion) order.\n","required":false,"schema":{"type":"string","isRequired":false,"description":"Order items by one of this Collection's own field keys (optionally prefixed with `-` for descending). The value must match a field actually defined on the Collection's schema. Pages-style meta keys like `published`/`updated` are not valid here and return a `403`.\n\nWhen omitted, items are returned in natural (insertion) order.\n","uniqueKey":"","typeLabel":"string"},"examples":{"ascending":{"value":"label","description":"Order by a collection field, ascending"},"descending":{"value":"-label","description":"Order by a collection field, descending"}}},"92aecba6-4b79-4200-9d3c-e312d3a55076":{"name":"page","in":"query","description":"Page number for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","required":false,"schema":{"type":"integer","default":1,"minimum":1,"isRequired":false,"description":"Page number for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","uniqueKey":"","typeLabel":"integer"},"example":2},"491a13d9-5381-4b9c-a599-0cb614532cd3":{"name":"page_size","in":"query","description":"Number of items per page for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","required":false,"schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"isRequired":false,"description":"Number of items per page for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","uniqueKey":"","typeLabel":"integer"},"example":5},"c86d25f8-33af-4746-a91b-30c9a618c390":{"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"}}},"6ca4b44e-2fbb-478d-93fc-331a8082fb88":{"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)"}}},"0176d3d5-e2f0-4030-b617-5a2107fb8215":{"name":"alt_media_text","in":"query","description":"Media field response format.\n\nAffects only media-typed fields. Other field types are unchanged.\n\n- **0** (default): Media fields return simple URL strings\n- **1**: Media fields return objects with at least `url` and, when available,\n `alt`. If the stored media value is just a URL string, the object will\n include `url` only.\n","required":false,"schema":{"type":"integer","enum":[0,1],"default":0,"isRequired":false,"description":"Media field response format.\n\nAffects only media-typed fields. Other field types are unchanged.\n\n- **0** (default): Media fields return simple URL strings\n- **1**: Media fields return objects with at least `url` and, when available,\n `alt`. If the stored media value is just a URL string, the object will\n include `url` only.\n","uniqueKey":"","typeLabel":"enum\u003cinteger>"},"examples":{"url_only":{"value":0,"description":"Return media as URL strings (default)"},"object_format":{"value":1,"description":"Return media as objects with at least url (alt included when available)"}}},"65c41ad0-c218-4aeb-9af5-4bd3c8999db3":{"name":"fields","in":"query","required":false,"schema":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"additionalProperties","typeLabel":"string"},"isRequired":false,"description":"Dynamic field filtering using individual `fields.\u003cfield_name>=\u003cvalue>` query parameters (not an OpenAPI deepObject-style parameter).\n\nFilter collection items by any field using the pattern `fields.{field_name}=value`:\n- `fields.genre=Rock` - Filter by genre field\n- `fields.status=published` - Filter by status field\n- `fields.year=2023` - Filter by year field\n\nMultiple field filters can be combined in a single request.\n","uniqueKey":"","typeLabel":"object"},"description":"Dynamic field filtering using individual `fields.\u003cfield_name>=\u003cvalue>` query parameters (not an OpenAPI deepObject-style parameter).\n\nFilter collection items by any field using the pattern `fields.{field_name}=value`:\n- `fields.genre=Rock` - Filter by genre field\n- `fields.status=published` - Filter by status field\n- `fields.year=2023` - Filter by year field\n\nMultiple field filters can be combined in a single request.\n","examples":{"genre_filter":{"summary":"Filter by genre","value":{"genre":"Rock"}},"status_filter":{"summary":"Filter by status","value":{"status":"published"}},"multi_filter":{"summary":"Multiple filters","value":{"genre":"Rock","year":"2023"}}}}},"responses":{"cd8e059f-601f-4beb-91c6-036699b0859a":{"description":"Collection retrieved successfully","content":{"application/json":{"schema":{"type":"object","description":"Collection response using page-based pagination","properties":{"meta":{"type":"object","description":"Pagination metadata for collection retrieval","properties":{"count":{"type":"integer","description":"Total number of items in the collection (across all pages)","example":150,"uniqueKey":"meta.count","typeLabel":"integer"},"next_page":{"oneOf":[{"type":"integer","description":"Next page number if more pages exist, null if this is the last page","example":3,"uniqueKey":"meta.next_page.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Next page number if more pages exist, null if this is the last page","example":3,"uniqueKey":"meta.next_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.next_page","typeLabel":"integer | null"},"previous_page":{"oneOf":[{"type":"integer","description":"Previous page number if previous pages exist, null if this is the first page","example":1,"uniqueKey":"meta.previous_page.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Previous page number if previous pages exist, null if this is the first page","example":1,"uniqueKey":"meta.previous_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.previous_page","typeLabel":"integer | null"}},"isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"data":{"type":"object","description":"Collection data object with dynamic key based on collection name","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[]"},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["meta","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"artists_collection":{"title":"artists_collection","summary":"Artists collection response","value":{"meta":{"count":25,"next_page":3,"previous_page":1},"data":{"artists":[{"meta":{"id":123},"name":"The Beatles","genre":"Rock","formed_year":1960,"description":"Legendary British rock band"},{"meta":{"id":124},"name":"The Rolling Stones","genre":"Rock","formed_year":1962,"description":"Iconic rock and roll band"}]}}},"filtered_response":{"title":"filtered_response","summary":"Filtered collection response","value":{"meta":{"count":5,"next_page":null,"previous_page":null},"data":{"products":[{"meta":{"id":456},"title":"Premium Headphones","category":"Electronics","price":299.99,"in_stock":true}]}}},"localized_response":{"title":"localized_response","summary":"Localized collection response","value":{"meta":{"count":10,"next_page":2,"previous_page":null},"data":{"articles":[{"meta":{"id":789},"title":"Bonjour le monde","content":"Contenu en français...","locale":"fr"}]}}},"media_url_format":{"title":"media_url_format","summary":"Media field as URL string (alt_media_text=0)","description":"When `alt_media_text=0` (default), media fields are returned as URL strings.\n","value":{"meta":{"count":1,"next_page":null,"previous_page":null},"data":{"products":[{"meta":{"id":900},"title":"Poster","media":"https://cdn.example.com/media/poster.jpg"}]}}},"media_object_format":{"title":"media_object_format","summary":"Media field as object (alt_media_text=1)","description":"When `alt_media_text=1`, media fields are returned as objects. The object always includes `url`, and `alt` is included when available.\n","value":{"meta":{"count":1,"next_page":null,"previous_page":null},"data":{"products":[{"meta":{"id":901},"title":"Poster","media":{"url":"https://cdn.example.com/media/poster.jpg","alt":"Movie poster artwork"}}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"1705006c-b2af-4dcd-b268-895f97b9fdec":{"description":"**Bad Request - Invalid locale or levels**\n\nThe `locale` isn't configured on this account, or `levels` isn't an integer. Integer `levels` values outside 1-5 are clamped, not rejected.\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Response for validation errors (400 Bad Request). The shape varies by endpoint and check: a field-keyed object whose values are arrays of messages or single message strings, a bare array of messages, or a general `error` message.","example":{"title":["This field is required."],"slug":"You must specify a page slug."},"additionalProperties":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.additionalProperties.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.additionalProperties.oneOf.0","typeLabel":"string[]"},{"type":"string","uniqueKey":"oneOf.0.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"oneOf.0.additionalProperties","typeLabel":"string[] | string"},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Response for validation errors (400 Bad Request). The shape varies by endpoint and check: a field-keyed object whose values are arrays of messages or single message strings, a bare array of messages, or a general `error` message.","example":["'field1_key' is required"],"uniqueKey":"oneOf.1","typeLabel":"string[]"},{"type":"object","description":"Response for validation errors (400 Bad Request). The shape varies by endpoint and check: a field-keyed object whose values are arrays of messages or single message strings, a bare array of messages, or a general `error` message.","example":{"error":"Cannot create a new Collection Item. Collection Item Limit Reached."},"properties":{"error":{"type":"string","description":"Error message","uniqueKey":"oneOf.2.error","typeLabel":"string"}},"uniqueKey":"oneOf.2","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object · string[] · object"},"examples":{"invalid_locale":{"title":"invalid_locale","summary":"Locale not configured for this account","value":{"locale":"The passed locale isn't configured on this account."}},"invalid_levels":{"title":"invalid_levels","summary":"Non-integer levels parameter","value":{"detail":"levels query parameter should be an integer between 1 and 5 (inclusive)"}}},"exampleType":"examples"}},"exampleType":"examples"},"e466ecab-c7be-4c0e-b2c6-4f9b98476157":{"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"},"3647d949-9351-45ef-a58a-d56ff3804456":{"description":"**Forbidden - Invalid Order or Filter Key**\n\nThe `order` parameter, or a `fields.\u003cname>` filter key, doesn't match a field defined on this Collection.\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"},"examples":{"invalid_order":{"title":"invalid_order","summary":"Invalid order key","value":{"detail":"published is not a valid key to order by."}},"invalid_filter":{"title":"invalid_filter","summary":"Invalid filter key","value":{"detail":"Invalid filter key nonexistent_field"}}},"exampleType":"examples"}},"exampleType":"examples"},"68b7b71f-bd90-4e11-a7c8-baabe0052f7c":{"description":"**Not Found - Collection Does Not Exist**\n\nNote: an out-of-range `page` is not consistently a `404` across accounts: most accounts get `200` with an empty `data` array and `next_page: null`; some get `404` with `{\"detail\": \"Invalid Page.\"}`.\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"},"examples":{"collection_not_found":{"title":"collection_not_found","summary":"Collection not found","value":{"detail":"Not found."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"977db969-ad01-4a6e-a793-fc906be8097c":{"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"}},"e629a3d1-ef7d-4cb3-889d-3dd712f1aa7c":{"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 Collection - ButterCMS Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T14:11:45.727Z","originalFileLocation":"api-reference/collections/retrieve-collection.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 a specific Collection with comprehensive filtering, pagination, and relationship serialization.\">\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 Collection - ButterCMS Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization.\">\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-collection\">\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+Collection\u0026amp;description=Retrieve+items+from+a+specific+Collection+with+comprehensive+filtering%2C+pagination%2C+and+relationship+serialization.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=ee07bf0ab85d6033bd18f323b46d3ac64a6ea3f4ee77c17488c947779f600399\">\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 Collection - ButterCMS Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://buttercms.mintlify.site/docs/_mintlify/api/og/v2?division=Collections\u0026amp;title=Retrieve+Collection\u0026amp;description=Retrieve+items+from+a+specific+Collection+with+comprehensive+filtering%2C+pagination%2C+and+relationship+serialization.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=ee07bf0ab85d6033bd18f323b46d3ac64a6ea3f4ee77c17488c947779f600399\">\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-collection\">\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-collection.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-collection#webpage\",\"url\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection\",\"name\":\"Retrieve Collection\",\"description\":\"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization.\",\"dateModified\":\"2026-10-27T14:11:45.727Z\",\"isPartOf\":{\"@id\":\"https://buttercms.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection#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\":\"Collections\",\"item\":\"https://buttercms.com/docs/api-reference/collections/retrieve-multiple-collections-by-key\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve Collection\",\"item\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection#apireference\",\"headline\":\"Retrieve Collection\",\"name\":\"Retrieve Collection\",\"description\":\"Retrieve items from a specific Collection with comprehensive filtering, pagination, and relationship serialization.\",\"url\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection\",\"mainEntityOfPage\":{\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection#webpage\"},\"dateModified\":\"2026-10-27T14:11:45.727Z\",\"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-collection.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","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","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"},{"title":"Retrieve Collection","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/{collection_key}/","href":"/api-reference/collections/retrieve-collection"},{"title":"Retrieve Collection Item","description":"Retrieve a single Collection item by its numeric item ID.","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 Collection - 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"]}