Retrieve a single Collection item directly by its numeric item ID, instead of paging through the full collection. This is the same ID returned in every item’s meta.id field.Draft Items: By default only a published item is returned. Pass ?preview=1 to retrieve a draft item, or to preview draft field values on an otherwise-published item.
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 containing the item.
Must match an existing collection in your organization.
Maximum string length: 50
item_id
string
required
The numeric ID of the collection item, as returned in meta.id by the list/retrieve-collection endpoints.
Maximum string length: 50
Query Parameters
auth_token
string
Your ButterCMS read API token
preview
enum<integer>
default:0
Set to 1 to retrieve a draft item, or to preview draft field values on an otherwise-published item.
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
Collection item retrieved successfully
data
object
Individual collection item with dynamic field structure and metadata
Show child attributes
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" }
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-item","slug":"/api-reference/collections/retrieve-collection-item","pageMetadata":{"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","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 a single Collection item by its numeric item ID.\"\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 a single Collection item directly by its numeric item ID, instead of paging through the full collection. This is the same ID returned in every item’s `,_jsx(_components.code,{children:`meta.id`}),` field.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Draft Items`}),`: By default only a published item is returned. Pass `,_jsx(_components.code,{children:`?preview=1`}),` to retrieve a draft item, or to preview draft field values on an otherwise-published item.`]})]})}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 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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Collections"],"summary":"Retrieve Collection Item","description":"Retrieve a single Collection item by its numeric item ID.","x-mint":{"metadata":{"description":"Retrieve a single Collection item by its numeric item ID."},"content":"Retrieve a single Collection item directly by its numeric item ID, instead of paging through the full collection. This is the same ID returned in every item's `meta.id` field.\n\n**Draft Items**: By default only a published item is returned. Pass `?preview=1` to retrieve a draft item, or to preview draft field values on an otherwise-published item.\n"},"operationId":"retrieveCollectionItem","security":["67476b52-dbc2-40c2-abd6-4f38b48eada2","c2b8aab0-b1d6-4427-85c4-396606d84923"],"parameters":["033e5bde-0bac-49d4-baa7-89f1a17b1367","0e6b75f2-8eba-419c-982f-278a1d1ec435","43125159-cdbb-47d6-94d7-c413d120ead4","5999c18e-04cf-4fdc-ae92-e8a7c442f480","ff799248-40ff-4eea-9fb8-ae1dc9548922","00712a7a-3a7f-400d-9a1f-567de16fda59"],"responses":{"200":"cddbc773-b40d-4a56-932a-c10ed32f40f2","401":"76fac63d-be8a-4133-ae17-d8562b9e69a9","404":"aaed50bf-fb5f-461f-89b1-8f91273d4710"},"method":"get","type":"path","servers":["5245510f-95b6-4fd0-b4e8-4159dcc1f97b"],"path":"/content/{collection_key}/{item_id}/","baseUrlOptions":["https://api.buttercms.com/v2"],"title":"Retrieve Collection Item","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"033e5bde-0bac-49d4-baa7-89f1a17b1367":{"name":"collection_key","in":"path","required":true,"schema":{"type":"string","maxLength":50,"isRequired":true,"description":"The unique identifier/slug of the Collection containing the item.\n\nMust match an existing collection in your organization.\n","uniqueKey":"","typeLabel":"string"},"description":"The unique identifier/slug of the Collection containing the item.\n\nMust match an existing collection in your organization.\n","example":"navigation_menu_item"},"0e6b75f2-8eba-419c-982f-278a1d1ec435":{"name":"item_id","in":"path","required":true,"schema":{"type":"string","maxLength":50,"isRequired":true,"description":"The numeric ID of the collection item, as returned in `meta.id` by the list/retrieve-collection endpoints.\n","uniqueKey":"","typeLabel":"string"},"description":"The numeric ID of the collection item, as returned in `meta.id` by the list/retrieve-collection endpoints.\n","example":"790691"},"43125159-cdbb-47d6-94d7-c413d120ead4":{"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"},"5999c18e-04cf-4fdc-ae92-e8a7c442f480":{"name":"preview","in":"query","description":"Set to 1 to retrieve a draft item, or to preview draft field values on an otherwise-published item.\n","required":false,"schema":{"type":"integer","enum":[0,1],"default":0,"isRequired":false,"description":"Set to 1 to retrieve a draft item, or to preview draft field values on an otherwise-published item.\n","uniqueKey":"","typeLabel":"enum\u003cinteger>"},"example":1},"ff799248-40ff-4eea-9fb8-ae1dc9548922":{"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"}}},"00712a7a-3a7f-400d-9a1f-567de16fda59":{"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":{"cddbc773-b40d-4a56-932a-c10ed32f40f2":{"description":"Collection item retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"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.meta.id","typeLabel":"integer"}},"required":["id"],"uniqueKey":"data.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","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"published_item":{"title":"published_item","summary":"Published item","value":{"data":{"meta":{"id":790691},"label":"Home","url":"#home"}}},"draft_item_with_preview":{"title":"draft_item_with_preview","summary":"Draft item (preview=1)","value":{"data":{"meta":{"id":790706},"label":"Draft Item Audit","url":"https://example.com/draft"}}},"references_collapsed_at_levels_1":{"title":"references_collapsed_at_levels_1","summary":"Nested references as URIs (levels=1)","description":"At `levels=1`, a reference field (here, a Collection reference) is returned as an array of API URI strings instead of being expanded inline.\n","value":{"data":{"meta":{"id":790697},"name":"Main menu","menu_items":["/v2/content/?keys=navigation_menu_item[_id=790691]","/v2/content/?keys=navigation_menu_item[_id=790692]"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"76fac63d-be8a-4133-ae17-d8562b9e69a9":{"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"},"aaed50bf-fb5f-461f-89b1-8f91273d4710":{"description":"**Not Found - Item Does Not Exist or Not Published**\n\nEither the item ID doesn't exist for this collection, or it exists but has no published version and `preview=1` wasn't passed.\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":{"item_not_found":{"title":"item_not_found","summary":"Item not found","value":{"detail":"Item not found."}},"no_published_version":{"title":"no_published_version","summary":"Item exists but is not published","value":{"detail":"No published version of this collection item found. If you're trying to preview a draft, pass in ?preview=1."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"67476b52-dbc2-40c2-abd6-4f38b48eada2":{"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"}},"c2b8aab0-b1d6-4427-85c4-396606d84923":{"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 Item - ButterCMS Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T14:11:45.743Z","originalFileLocation":"api-reference/collections/retrieve-collection-item.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 a single Collection item by its numeric item ID.\">\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 Item - ButterCMS Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a single Collection item by its numeric item ID.\">\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-item\">\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+Item\u0026amp;description=Retrieve+a+single+Collection+item+by+its+numeric+item+ID.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=68da5cecbe910e930627cb280555c9ca6bbb4d0a92985650193cc2cb00a33ddd\">\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 Item - ButterCMS Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a single Collection item by its numeric item ID.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://buttercms.mintlify.site/docs/_mintlify/api/og/v2?division=Collections\u0026amp;title=Retrieve+Collection+Item\u0026amp;description=Retrieve+a+single+Collection+item+by+its+numeric+item+ID.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=68da5cecbe910e930627cb280555c9ca6bbb4d0a92985650193cc2cb00a33ddd\">\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-item\">\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-item.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-item#webpage\",\"url\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection-item\",\"name\":\"Retrieve Collection Item\",\"description\":\"Retrieve a single Collection item by its numeric item ID.\",\"dateModified\":\"2026-10-27T14:11:45.743Z\",\"isPartOf\":{\"@id\":\"https://buttercms.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection-item#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection-item#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\",\"item\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection-item\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection-item#apireference\",\"headline\":\"Retrieve Collection Item\",\"name\":\"Retrieve Collection Item\",\"description\":\"Retrieve a single Collection item by its numeric item ID.\",\"url\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection-item\",\"mainEntityOfPage\":{\"@id\":\"https://buttercms.com/docs/api-reference/collections/retrieve-collection-item#webpage\"},\"dateModified\":\"2026-10-27T14:11:45.743Z\",\"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-item.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","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","description":"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.","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 Item - 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"]}