{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/schema.json","name":"Rewind","description":"Personal data aggregation API. Syncs and serves data from the services that track your life.","colors":{"primary":"#6874e8","light":"#8b94f0","dark":"#6874e8"},"logo":{"light":"https://mintcdn.com/rewindrest/Tls5eCxt2of69vdc/logo/light.svg?fit=max\u0026auto=format\u0026n=Tls5eCxt2of69vdc\u0026q=85\u0026s=4daa7e64596acddb1e9ff3083705811c","dark":"https://mintcdn.com/rewindrest/Tls5eCxt2of69vdc/logo/dark.svg?fit=max\u0026auto=format\u0026n=Tls5eCxt2of69vdc\u0026q=85\u0026s=056d6954501a5d93a26a5972cb33c6dd"},"favicon":"https://mintcdn.com/rewindrest/ImB3CC59ZACJpC4S/favicon.svg?fit=max\u0026auto=format\u0026n=ImB3CC59ZACJpC4S\u0026q=85\u0026s=8bbccad2db169fe7ff12cf1b8a8bb89c","api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python"],"prefill":true}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#ffffff","dark":"#0a0a0a"}},"navbar":{"primary":{"type":"button","label":"Get Started","href":"/quickstart"}},"footer":{"socials":{"github":"https://github.com/pdugan20/rewind"}},"search":{"prompt":"Search docs..."},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"thumbnails":{"appearance":"light"},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rewindrest","hasAudioNarration":false,"actualSubdomain":"rewindrest","customDomains":["docs.rewind.rest"],"gitSource":{"type":"github","owner":"pdugan20","repo":"rewind","deployBranch":"main","contentDirectory":"docs-mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad9a2206e3708577a944f7e","collectionId":"b0402fcf-e657-4ebb-83aa-2f18ae15cacb","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad9a2206e3708577a944f7e"},"entitlements":{},"buildId":"6ad9a2206e3708577a944f7e","clientVersion":"0.0.3926","searchFilterCounts":[{"language":"default","tag":"API Reference","count":102},{"language":"default","tag":"Listening","count":19},{"language":"default","tag":"Running","count":19},{"language":"default","tag":"Collecting","count":16},{"language":"default","tag":"Reading","count":15},{"language":"default","tag":"Watching","count":15},{"language":"default","tag":"Guides","count":13},{"language":"default","tag":"MCP","count":12},{"language":"default","tag":"Attending","count":9},{"language":"default","tag":"Domains","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"editor-nav-generations","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":"vite-origin","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":"byok-sep-25","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":"editor-agent-model-picker","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}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":"img[src*='/images/']{border-radius:1rem}"}],"page":{"pagePath":"api-reference/listening/all-year-summaries","slug":"/api-reference/listening/all-year-summaries","pageMetadata":{"openapi":"get /v1/listening/years","title":"All year summaries","description":"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.","href":"/api-reference/listening/all-year-summaries"},"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: \"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":{"openapi":"get /v1/listening/years","title":"All year summaries","description":"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.","href":"/api-reference/listening/all-year-summaries"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listListeningYears","tags":["Listening"],"summary":"All year summaries","description":"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.","responses":{"200":"37dfec8d-f3a4-48ca-b11a-d4876a28760a","401":"bff2fc26-74f2-4bc0-ac6b-94eee75bc4a3"},"method":"get","type":"path","servers":["6a3ed85c-8889-4950-8882-7000f201bfa7"],"security":["929bf14c-46a0-4fc1-af14-728752c50f60"],"path":"/v1/listening/years","baseUrlOptions":["https://api.rewind.rest"],"title":"All year summaries","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{},"responses":{"37dfec8d-f3a4-48ca-b11a-d4876a28760a":{"description":"Year summaries, newest first","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].year","typeLabel":"number"},"total_scrobbles":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].total_scrobbles","typeLabel":"number"},"unique_artists":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].unique_artists","typeLabel":"number"},"unique_albums":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].unique_albums","typeLabel":"number"},"unique_tracks":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].unique_tracks","typeLabel":"number"},"top_artist":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].top_artist.oneOf.0.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].top_artist.oneOf.0.name","typeLabel":"string"}},"required":["id","name"],"uniqueKey":"data.items.[INDEX].top_artist.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"uniqueKey":"data.items.[INDEX].top_artist.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].top_artist","typeLabel":"object | null"}},"required":["year","total_scrobbles","unique_artists","unique_albums","unique_tracks"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"example":{"data":[{"year":2026,"total_scrobbles":3200,"unique_artists":180,"unique_albums":410,"unique_tracks":1250,"top_artist":{"id":92,"name":"Taylor Swift"}},{"year":2025,"total_scrobbles":12345,"unique_artists":234,"unique_albums":567,"unique_tracks":890,"top_artist":{"id":189,"name":"Nirvana"}}]},"examples":{"Example":{"title":"Example","value":{"data":[{"year":2026,"total_scrobbles":3200,"unique_artists":180,"unique_albums":410,"unique_tracks":1250,"top_artist":{"id":92,"name":"Taylor Swift"}},{"year":2025,"total_scrobbles":12345,"unique_artists":234,"unique_albums":567,"unique_tracks":890,"top_artist":{"id":189,"name":"Nirvana"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"bff2fc26-74f2-4bc0-ac6b-94eee75bc4a3":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"type":"integer","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"}},"required":["error","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Not found","status":404}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"929bf14c-46a0-4fc1-af14-728752c50f60":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"6a3ed85c-8889-4950-8882-7000f201bfa7":{"url":"https://api.rewind.rest","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"rewindrest","siteName":"Rewind","title":"All year summaries - Rewind","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T16:00:02.994Z","originalFileLocation":"api-reference/listening/all-year-summaries.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=\"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rewind\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_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=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"All year summaries - Rewind\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rewind\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rewind.rest/api-reference/listening/all-year-summaries\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rewindrest.mintlify.app/_mintlify/api/og/v2?division=Listening\u0026amp;title=All+year+summaries\u0026amp;description=Returns+one+entry+per+year+tracked%2C+with+total+scrobbles+and+unique+artist%2C+album%2C+and+track+counts.\u0026amp;theme=ec91130ab9827ead59968e91\u0026amp;signature=fc0727c075484e4715d27e30fd7ed5a1dc41f3a12538a9cc626eb061d0f25cb0\">\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=\"All year summaries - Rewind\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rewindrest.mintlify.app/_mintlify/api/og/v2?division=Listening\u0026amp;title=All+year+summaries\u0026amp;description=Returns+one+entry+per+year+tracked%2C+with+total+scrobbles+and+unique+artist%2C+album%2C+and+track+counts.\u0026amp;theme=ec91130ab9827ead59968e91\u0026amp;signature=fc0727c075484e4715d27e30fd7ed5a1dc41f3a12538a9cc626eb061d0f25cb0\">\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=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rewind\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6874e8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rewind.rest/api-reference/listening/all-year-summaries\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/listening/all-year-summaries.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rewind.rest/#organization\",\"name\":\"Rewind\",\"url\":\"https://docs.rewind.rest\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rewindrest/Tls5eCxt2of69vdc/logo/light.svg?fit=max\u0026auto=format\u0026n=Tls5eCxt2of69vdc\u0026q=85\u0026s=4daa7e64596acddb1e9ff3083705811c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rewind.rest#website\",\"name\":\"Rewind\",\"url\":\"https://docs.rewind.rest\",\"publisher\":{\"@id\":\"https://docs.rewind.rest/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries#webpage\",\"url\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries\",\"name\":\"All year summaries\",\"description\":\"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.\",\"dateModified\":\"2026-10-13T16:00:02.994Z\",\"isPartOf\":{\"@id\":\"https://docs.rewind.rest#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Listening\",\"item\":\"https://docs.rewind.rest/api-reference/listening/now-playing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"All year summaries\",\"item\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries#apireference\",\"headline\":\"All year summaries\",\"name\":\"All year summaries\",\"description\":\"Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.\",\"url\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rewind.rest/api-reference/listening/all-year-summaries#webpage\"},\"dateModified\":\"2026-10-13T16:00:02.994Z\",\"publisher\":{\"@id\":\"https://docs.rewind.rest/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rewind.rest#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rewind\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Rewind","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Listening","pages":[{"openapi":"get /v1/listening/now-playing","title":"Now playing","href":"/api-reference/listening/now-playing"},{"openapi":"get /v1/listening/recent","title":"Recent scrobbles","href":"/api-reference/listening/recent-scrobbles"},{"openapi":"get /v1/listening/top/artists","title":"Top artists","href":"/api-reference/listening/top-artists"},{"openapi":"get /v1/listening/top/albums","title":"Top albums","href":"/api-reference/listening/top-albums"},{"openapi":"get /v1/listening/top/tracks","title":"Top tracks","href":"/api-reference/listening/top-tracks"},{"openapi":"get /v1/listening/stats","title":"Listening stats","href":"/api-reference/listening/listening-stats"},{"openapi":"get /v1/listening/history","title":"Listening history","href":"/api-reference/listening/scrobble-history"},{"openapi":"get /v1/listening/artists","title":"Browse artists","href":"/api-reference/listening/browse-artists"},{"openapi":"get /v1/listening/albums","title":"Browse albums","href":"/api-reference/listening/browse-albums"},{"openapi":"get /v1/listening/artists/{id}","title":"Artist detail","href":"/api-reference/listening/artist-detail"},{"openapi":"get /v1/listening/albums/{id}","title":"Album detail","href":"/api-reference/listening/album-detail"},{"openapi":"get /v1/listening/calendar","title":"Listening calendar","href":"/api-reference/listening/scrobble-calendar"},{"openapi":"get /v1/listening/trends","title":"Listening trends","href":"/api-reference/listening/listening-trends"},{"openapi":"get /v1/listening/streaks","title":"Listening streaks","href":"/api-reference/listening/listening-streaks"},{"openapi":"get /v1/listening/year/{year}","title":"Year in review","href":"/api-reference/listening/year-in-review"},{"openapi":"get /v1/listening/genres","title":"Genre breakdown","href":"/api-reference/listening/genre-breakdown"},{"openapi":"get /v1/listening/recent/albums","title":"Recently played albums","href":"/api-reference/listening/recently-played-albums"},{"openapi":"get /v1/listening/discman","title":"Prepared recent albums with tracklists","description":"Returns up to 12 most recently played distinct albums that have accepted CD artwork and at least one song preview, newest first, with no time window. Albums whose disc art is missing, pending, or hidden, or with no preview for any song, are skipped, so a shelf can reach past newer listening. Each album includes its Apple Music catalog tracklist in disc/track order when stored (otherwise the songs played from it), previews, Apple Music links, artist image, all image sizes, and per-track play counts and last-played times. Prepared after each 15-minute scrobble sync, so newly accepted art appears at the next rebuild; no live provider requests. Supports If-None-Match.","href":"/api-reference/listening/recent-albums-shelf"},{"openapi":"get /v1/listening/years","title":"All year summaries","href":"/api-reference/listening/all-year-summaries"}]},{"group":"Running","pages":[{"openapi":"get /v1/running/stats","title":"Running stats","description":"Returns aggregate lifetime running statistics.","href":"/api-reference/running/lifetime-running-statistics"},{"openapi":"get /v1/running/stats/years","title":"All year summaries","href":"/api-reference/running/all-year-summaries"},{"openapi":"get /v1/running/stats/years/{year}","title":"Single year summary","href":"/api-reference/running/single-year-summary"},{"openapi":"get /v1/running/prs","title":"Personal records","href":"/api-reference/running/personal-records"},{"openapi":"get /v1/running/recent","title":"Latest runs","href":"/api-reference/running/recent-activities"},{"openapi":"get /v1/running/activities","title":"List activities","href":"/api-reference/running/list-activities"},{"openapi":"get /v1/running/activities/{id}","title":"Activity detail","href":"/api-reference/running/activity-detail"},{"openapi":"get /v1/running/activities/{id}/splits","title":"Activity splits","href":"/api-reference/running/activity-splits"},{"openapi":"get /v1/running/gear","title":"Gear list","href":"/api-reference/running/gear-list"},{"openapi":"get /v1/running/calendar","title":"Activity calendar","href":"/api-reference/running/activity-calendar"},{"openapi":"get /v1/running/charts/cumulative","title":"Cumulative distance chart","href":"/api-reference/running/cumulative-distance-chart"},{"openapi":"get /v1/running/charts/pace-trend","title":"Pace trend chart","href":"/api-reference/running/pace-trend-chart"},{"openapi":"get /v1/running/charts/time-of-day","title":"Time of day chart","href":"/api-reference/running/time-of-day-chart"},{"openapi":"get /v1/running/charts/elevation","title":"Elevation chart","href":"/api-reference/running/elevation-chart"},{"openapi":"get /v1/running/cities","title":"Cities","href":"/api-reference/running/cities"},{"openapi":"get /v1/running/streaks","title":"Running streaks","href":"/api-reference/running/running-streaks"},{"openapi":"get /v1/running/races","title":"Race activities","href":"/api-reference/running/race-activities"},{"openapi":"get /v1/running/eddington","title":"Eddington number","href":"/api-reference/running/eddington-number"},{"openapi":"get /v1/running/year/{year}","title":"Year in review","href":"/api-reference/running/year-in-review"}]},{"group":"Watching","pages":[{"openapi":"get /v1/watching/recent","title":"Recent watches","href":"/api-reference/watching/recent-watches"},{"openapi":"get /v1/watching/movies","title":"List movies","href":"/api-reference/watching/list-movies"},{"openapi":"get /v1/watching/movies/{id}","title":"Movie detail","href":"/api-reference/watching/movie-detail"},{"openapi":"get /v1/watching/stats","title":"Watch stats","href":"/api-reference/watching/watch-stats"},{"openapi":"get /v1/watching/stats/genres","title":"Genre stats","href":"/api-reference/watching/genre-stats"},{"openapi":"get /v1/watching/stats/decades","title":"Decade stats","href":"/api-reference/watching/decade-stats"},{"openapi":"get /v1/watching/stats/directors","title":"Director stats","href":"/api-reference/watching/director-stats"},{"openapi":"get /v1/watching/calendar","title":"Watch calendar","href":"/api-reference/watching/watch-calendar"},{"openapi":"get /v1/watching/trends","title":"Watch trends","href":"/api-reference/watching/watch-trends"},{"openapi":"get /v1/watching/shows","title":"List TV shows","href":"/api-reference/watching/list-tv-shows"},{"openapi":"get /v1/watching/shows/{id}","title":"Show detail","href":"/api-reference/watching/show-detail"},{"openapi":"get /v1/watching/shows/{id}/seasons/{season}","title":"Season detail","href":"/api-reference/watching/season-detail"},{"openapi":"get /v1/watching/ratings","title":"Rated movies","href":"/api-reference/watching/rated-movies"},{"openapi":"get /v1/watching/reviews","title":"Movie reviews","href":"/api-reference/watching/movie-reviews"},{"openapi":"get /v1/watching/year/{year}","title":"Year in review","href":"/api-reference/watching/year-in-review"}]},{"group":"Reading","pages":[{"openapi":"get /v1/reading/recent","title":"Recent articles","href":"/api-reference/reading/recent-articles"},{"openapi":"get /v1/reading/currently-reading","title":"Currently reading","href":"/api-reference/reading/currently-reading"},{"openapi":"get /v1/reading/articles","title":"List articles","href":"/api-reference/reading/list-articles"},{"openapi":"get /v1/reading/articles/{id}","title":"Article detail","href":"/api-reference/reading/article-detail"},{"openapi":"get /v1/reading/archive","title":"Archived articles","href":"/api-reference/reading/archived-articles"},{"openapi":"get /v1/reading/highlights","title":"List highlights","href":"/api-reference/reading/list-highlights"},{"openapi":"get /v1/reading/highlights/random","title":"Random highlight","href":"/api-reference/reading/random-highlight"},{"openapi":"get /v1/reading/stats","title":"Reading stats","href":"/api-reference/reading/reading-stats"},{"openapi":"get /v1/reading/calendar","title":"Reading calendar","href":"/api-reference/reading/reading-calendar"},{"openapi":"get /v1/reading/streaks","title":"Reading streaks","href":"/api-reference/reading/reading-streaks"},{"openapi":"get /v1/reading/tags","title":"Tag breakdown","href":"/api-reference/reading/tag-breakdown"},{"openapi":"get /v1/reading/domains","title":"Top domains","href":"/api-reference/reading/top-domains"},{"openapi":"get /v1/reading/year/{year}","title":"Year in review","href":"/api-reference/reading/year-in-review"},{"openapi":"get /v1/reading/articles/{id}/related","title":"Related articles (semantic similarity)","href":"/api-reference/reading/related-articles"},{"openapi":"get /v1/reading/highlights/{id}","title":"Highlight detail","href":"/api-reference/reading/highlight-detail"}]},{"group":"Collecting","pages":[{"openapi":"get /v1/collecting/vinyl","title":"List vinyl collection","href":"/api-reference/collecting/list-vinyl-collection"},{"openapi":"get /v1/collecting/stats","title":"Collection stats","href":"/api-reference/collecting/collection-statistics"},{"openapi":"get /v1/collecting/recent","title":"Recent vinyl additions","href":"/api-reference/collecting/recent-additions"},{"openapi":"get /v1/collecting/vinyl/{id}","title":"Vinyl record detail","href":"/api-reference/collecting/collection-item-detail"},{"openapi":"get /v1/collecting/wantlist","title":"Wantlist","href":"/api-reference/collecting/wantlist"},{"openapi":"get /v1/collecting/formats","title":"Format breakdown","href":"/api-reference/collecting/format-breakdown"},{"openapi":"get /v1/collecting/genres","title":"Genre breakdown","href":"/api-reference/collecting/genre-breakdown"},{"openapi":"get /v1/collecting/artists","title":"Top collected artists","href":"/api-reference/collecting/top-artists"},{"openapi":"get /v1/collecting/cross-reference","title":"Collection-listening cross-reference","href":"/api-reference/collecting/collection-listening-cross-reference"},{"openapi":"get /v1/collecting/calendar","title":"Collection calendar","href":"/api-reference/collecting/collection-calendar"},{"openapi":"get /v1/collecting/media","title":"List physical media collection","href":"/api-reference/collecting/list-physical-media-collection"},{"openapi":"get /v1/collecting/media/stats","title":"Physical media stats","href":"/api-reference/collecting/physical-media-statistics"},{"openapi":"get /v1/collecting/media/recent","title":"Recently added physical media","href":"/api-reference/collecting/recently-added-physical-media"},{"openapi":"get /v1/collecting/media/formats","title":"Media format breakdown","href":"/api-reference/collecting/media-format-breakdown"},{"openapi":"get /v1/collecting/media/cross-reference","title":"Owned vs watched cross-reference","href":"/api-reference/collecting/owned-vs-watched-cross-reference"},{"openapi":"get /v1/collecting/media/{id}","title":"Physical media item detail","href":"/api-reference/collecting/physical-media-item-detail"}]},{"group":"Attending","pages":[{"openapi":"get /v1/attending/events","title":"List attended events","href":"/api-reference/attending/list-attended-events"},{"openapi":"get /v1/attending/events/{id}","title":"Get an attended event","href":"/api-reference/attending/get-attended-event"},{"openapi":"get /v1/attending/seasons/{league}/{season}","title":"Attended games in a sports season","href":"/api-reference/attending/get-attended-season"},{"openapi":"get /v1/attending/venues","title":"List venues","href":"/api-reference/attending/list-venues"},{"openapi":"get /v1/attending/stats","title":"Aggregate attending stats","href":"/api-reference/attending/get-attending-stats"},{"openapi":"get /v1/attending/players","title":"List players you have watched play","href":"/api-reference/attending/list-attended-players"},{"openapi":"get /v1/attending/players/{id}","title":"Get a player you have watched play","href":"/api-reference/attending/get-attended-player"},{"openapi":"get /v1/attending/year/{year}","title":"Year in review","href":"/api-reference/attending/year-in-review"},{"openapi":"get /v1/attending/players/{id}/stats","title":"Per-player aggregate stats across attended games","href":"/api-reference/attending/attended-player-stats"}]},{"group":"Feed","pages":[{"openapi":"get /v1/feed","title":"Cross-domain activity feed","href":"/api-reference/feed/cross-domain-activity-feed"},{"openapi":"get /v1/feed/domain/{domain}","title":"Single-domain activity feed","href":"/api-reference/feed/single-domain-activity-feed"},{"openapi":"get /v1/feed/on-this-day","title":"On this day","href":"/api-reference/feed/on-this-day"},{"openapi":"get /v1/lately","title":"Prepared latest music and movie","href":"/api-reference/feed/lately"}]},{"group":"Search","pages":[{"openapi":"get /v1/search","title":"Cross-domain search","href":"/api-reference/search/cross-domain-search"}]},{"group":"System","pages":[{"openapi":"get /v1/health","title":"Health check","href":"/api-reference/system/health-check"},{"openapi":"get /v1/health/sync","title":"Sync health status","href":"/api-reference/system/sync-health-status"}]},{"group":"Images","pages":[{"openapi":"get /v1/images/{domain}/{entity_type}/{entity_id}/{size}","title":"Get image by entity","href":"/api-reference/images/get-image-by-entity"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","sidebarTitle":"Webhooks","icon":"webhook","href":"/api-reference/webhooks/overview"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"title":"All year summaries - Rewind","buildId":"dpl_9DauxEjb9gzCtcuhPQFbquJvx7FJ","deploymentId":"dpl_9DauxEjb9gzCtcuhPQFbquJvx7FJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D7-Gje8a.js","utils-KOiC3qHY.js","cloneDeep-DEhA10yQ.js","_Uint8Array-BIdfUDMD.js","isArray-9Clv05ut.js","utils-CmcaQEbY.js","toString-CsGphfAF.js","addUniqueKeysToSchema-4JTjWsHh.js","snippetPresets-ddvRvPzi.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-NlqoL_h5.js","isEqual-D9eQogBc.js","usePlaygroundInputsStore-D_c36cCU.js","shallow-D2OGx4iM.js","getApiPlaygroundDisplay-CMrT2UNh.js","ChevronDownIcon-C27UQjyC.js","CodeSnippet-D019nHfQ.js","CodeSnippets-BC8hDW4S.js","Page-CF9KAtIE.js","getPastedJson-DoxVtgHa.js","icon-Dtg1NSY8.js","MethodPill-BQ0_b2IL.js","DynamicMarkdown-BY_qDhTn.js","SectionHeading-wQwiJd89.js","ArrowRotateAnticlockwiseIcon-DDnTkD_e.js","CircleWarningIcon-DI7T-tmv.js","PlusIcon-CwhPVjTe.js","TrashIcon-DDC8cDJT.js","axios-vUo_bRtp.js","Markdown-BA8elm3x.js","clsx-D-31Aetf.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Bd0qg17S.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DM8kDBn3.js"]}