Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.
POST
/
v1
/
meters
/
{id}
/
preview
Preview an existing meter
curl --request POST \ --url https://api.creem.io/v1/meters/{id}/preview \ --header 'x-api-key: <api-key>'
The last 7 UTC days (today included), oldest first and zero-filled
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Creem","colors":{"primary":"#FFBE98","light":"#FFBE98","dark":"#B09CFB"},"logo":{"light":"https://mintcdn.com/creem/-AIVGXbrCJu_8i70/logo/light.svg?fit=max\u0026auto=format\u0026n=-AIVGXbrCJu_8i70\u0026q=85\u0026s=686f06f43a3d7e4c0456e22de64c8bae","dark":"https://mintcdn.com/creem/-AIVGXbrCJu_8i70/logo/dark.svg?fit=max\u0026auto=format\u0026n=-AIVGXbrCJu_8i70\u0026q=85\u0026s=7c9135ca8b2365d6ec3728dc087f694d"},"favicon":"https://mintcdn.com/creem/-AIVGXbrCJu_8i70/favicon.svg?fit=max\u0026auto=format\u0026n=-AIVGXbrCJu_8i70\u0026q=85\u0026s=92df9cacbac6c8f17dbeb2d8b6befb93","navbar":{"links":[{"href":"https://creem.io/contact","label":"Support"},{"href":"https://docs.creem.io/llms.txt","label":"llms.txt"},{"href":"https://docs.creem.io/llms-full.txt","label":"llms-full.txt"}],"primary":{"type":"button","label":"Creem","href":"https://creem.io"}},"footer":{"socials":{"x":"https://x.com/creem_io","linkedin":"https://www.linkedin.com/company/creemio"}},"seo":{"metatags":{"twitter:site":"@creem_io","og:site_name":"Creem Documentation","keywords":"merchant of record, payment api, saas billing, subscription management, global payments, MoR, affiliate program, affiliate marketing, referral program"},"indexing":"all"},"integrations":{"posthog":{"apiKey":"phc_placeholder_gabriel_will_provide","apiHost":"https://us.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/q3GKZs92Av"},{"anchor":"Blog","icon":"newspaper","href":"https://creem.io/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"creem","hasAudioNarration":false,"actualSubdomain":"creem","customDomains":["docs.creem.io"],"gitSource":{"type":"github","owner":"armitage-labs","repo":"creem","deployBranch":"main","contentDirectory":"packages/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae068cec9d0adb3afbc2c95","collectionId":"2fa55d35-6965-42a5-84f0-414da7321369","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae068cec9d0adb3afbc2c95"},"entitlements":{},"buildId":"6ae068cec9d0adb3afbc2c95","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Documentation","count":100},{"language":"default","tag":"API Reference","count":65},{"language":"default","tag":"Features","count":44},{"language":"default","tag":"Code","count":21},{"language":"default","tag":"Customer Credits","count":19},{"language":"default","tag":"SDKs","count":19},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Meters","count":9},{"language":"default","tag":"Get Started","count":9},{"language":"default","tag":"Webhooks","count":8}]},"assistantConfig":{},"basePath":"","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":"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":"billing-page-v2","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"#topbar-cta-button{color:#000}"}],"page":{"pagePath":"api-reference/endpoint/preview-existing-meter","slug":"/api-reference/endpoint/preview-existing-meter","pageMetadata":{"title":"Preview an existing meter","description":"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.","openapi":"post /v1/meters/{id}/preview","href":"/api-reference/endpoint/preview-existing-meter"},"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: \"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.\"\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":{"title":"Preview an existing meter","description":"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.","openapi":"post /v1/meters/{id}/preview","href":"/api-reference/endpoint/preview-existing-meter"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/creem/c0258fabb625b4ba/scripts/generate-api-docs.js"],"openApiReferenceData":{"operation":{"operationId":"previewExistingMeter","x-speakeasy-name-override":"previewExistingMeter","x-speakeasy-group":"meters","summary":"Preview an existing meter","description":"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.","parameters":["4a8497ac-49d7-481f-bd7f-f40dd5354ba8"],"responses":{"200":"31825e01-3dca-490e-8f2a-d58b84db3869","400":"2169464a-bdee-43dd-9683-b0bb2d12e348","401":"4deed065-ca18-4d99-90bb-a76c9d68b269","404":"705cf039-92c9-4ec4-ae6b-7b69e59705e2"},"tags":["Meters"],"security":["ef18510a-8fe9-487b-a6d0-a0a571d4df4d"],"method":"post","type":"path","servers":["ce73d8da-bcf3-4183-ac11-826f6188634a","a3b3db05-e3f5-4845-baed-eca093fbbcd7"],"path":"/v1/meters/{id}/preview","baseUrlOptions":["https://api.creem.io","https://test-api.creem.io"],"title":"Preview an existing meter","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4a8497ac-49d7-481f-bd7f-f40dd5354ba8":{"name":"id","required":true,"in":"path","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"31825e01-3dca-490e-8f2a-d58b84db3869":{"description":"Preview of the meter","content":{"application/json":{"schema":{"type":"object","properties":{"matched_events":{"type":"number","description":"Events the meter would count over the preview window","example":137,"isRequired":true,"uniqueKey":"matched_events","typeLabel":"number"},"units":{"type":"string","description":"Aggregated units over the whole window, as a string for BigInt safety","example":"4820","isRequired":true,"uniqueKey":"units","typeLabel":"string"},"distinct_customers":{"type":"number","description":"Distinct customers among the matching events","example":12,"isRequired":true,"uniqueKey":"distinct_customers","typeLabel":"number"},"daily":{"description":"The last 7 UTC days (today included), oldest first and zero-filled","type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"UTC calendar day","example":"2026-08-16","isRequired":true,"uniqueKey":"daily.items.[INDEX].date","typeLabel":"string"},"event_count":{"type":"number","description":"Matching events on this day","example":42,"isRequired":true,"uniqueKey":"daily.items.[INDEX].event_count","typeLabel":"number"},"value":{"type":"string","description":"The aggregation folded over this day alone, as a string for BigInt safety","example":"1280","isRequired":true,"uniqueKey":"daily.items.[INDEX].value","typeLabel":"string"}},"required":["date","event_count","value"],"uniqueKey":"daily.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"daily","typeLabel":"object[]"}},"required":["matched_events","units","distinct_customers","daily"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"matched_events":137,"units":"4820","distinct_customers":12,"daily":[{"date":"2026-08-16","event_count":42,"value":"1280"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"2169464a-bdee-43dd-9683-b0bb2d12e348":{"description":"Bad Request - Invalid input parameters","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"4deed065-ca18-4d99-90bb-a76c9d68b269":{"description":"Unauthorized - Invalid or missing API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"705cf039-92c9-4ec4-ae6b-7b69e59705e2":{"description":"Not Found - Resource does not exist","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"ef18510a-8fe9-487b-a6d0-a0a571d4df4d":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication. You can find your API key in the Creem dashboard under Settings > API Keys.","scopes":[]}}},"servers":{"ce73d8da-bcf3-4183-ac11-826f6188634a":{"url":"https://api.creem.io","description":"Production — live API for processing real transactions and data.","x-speakeasy-server-id":"prod"},"a3b3db05-e3f5-4845-baed-eca093fbbcd7":{"url":"https://test-api.creem.io","description":"Test — sandbox API for development and testing with no real charges.","x-speakeasy-server-id":"test"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication. You can find your API key in the Creem dashboard under Settings > API Keys.","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key for authentication. You can find your API key in the Creem dashboard under Settings > API Keys.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"x-api-key"}],"title":"ApiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"creem","siteName":"Creem","title":"Preview an existing meter - Creem","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T12:00:04.158Z","originalFileLocation":"api-reference/endpoint/preview-existing-meter.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=\"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.\">\u003cmeta data-mint-head name=\"keywords\" content=\"merchant of record, payment api, saas billing, subscription management, global payments, MoR, affiliate program, affiliate marketing, referral program\">\u003cmeta data-mint-head name=\"application-name\" content=\"Creem\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/creem/nizlPYWnvgrMkN5E/_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/creem/nizlPYWnvgrMkN5E/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/creem/nizlPYWnvgrMkN5E/_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/creem/nizlPYWnvgrMkN5E/_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/creem/nizlPYWnvgrMkN5E/_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/creem/nizlPYWnvgrMkN5E/_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/creem/nizlPYWnvgrMkN5E/_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/creem/nizlPYWnvgrMkN5E/_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/creem/nizlPYWnvgrMkN5E/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Preview an existing meter - Creem\">\u003cmeta data-mint-head property=\"og:description\" content=\"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Creem Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://creem.mintlify.app/_mintlify/api/og/v2?division=Meters\u0026amp;title=Preview+an+existing+meter\u0026amp;description=Dry-run+an+existing+meter+against+your+real+usage+over+the+last+7+whole+UTC+days+%28today+included%2C+future-dated+events+excluded%29.+Same+shape+as+the+unsaved-defin\u0026amp;theme=cafe6ce3ebe1df8d45ed0a88\u0026amp;signature=0226cd65176d4c98aa56d49146fa013bb12487595b70844369e4a017fc58953d\">\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=\"Preview an existing meter - Creem\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://creem.mintlify.app/_mintlify/api/og/v2?division=Meters\u0026amp;title=Preview+an+existing+meter\u0026amp;description=Dry-run+an+existing+meter+against+your+real+usage+over+the+last+7+whole+UTC+days+%28today+included%2C+future-dated+events+excluded%29.+Same+shape+as+the+unsaved-defin\u0026amp;theme=cafe6ce3ebe1df8d45ed0a88\u0026amp;signature=0226cd65176d4c98aa56d49146fa013bb12487595b70844369e4a017fc58953d\">\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/creem/nizlPYWnvgrMkN5E/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Creem\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FFBE98\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/preview-existing-meter.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.creem.io/#organization\",\"name\":\"Creem\",\"url\":\"https://docs.creem.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/creem/-AIVGXbrCJu_8i70/logo/light.svg?fit=max\u0026auto=format\u0026n=-AIVGXbrCJu_8i70\u0026q=85\u0026s=686f06f43a3d7e4c0456e22de64c8bae\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.creem.io#website\",\"name\":\"Creem\",\"url\":\"https://docs.creem.io\",\"publisher\":{\"@id\":\"https://docs.creem.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter#webpage\",\"url\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter\",\"name\":\"Preview an existing meter\",\"description\":\"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.\",\"dateModified\":\"2026-09-14T12:00:04.158Z\",\"isPartOf\":{\"@id\":\"https://docs.creem.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Features\",\"item\":\"https://docs.creem.io/features/checkout/checkout-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Meters\",\"item\":\"https://docs.creem.io/api-reference/endpoint/create-meter\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Preview an existing meter\",\"item\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter#apireference\",\"headline\":\"Preview an existing meter\",\"name\":\"Preview an existing meter\",\"description\":\"Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.\",\"url\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter\",\"mainEntityOfPage\":{\"@id\":\"https://docs.creem.io/api-reference/endpoint/preview-existing-meter#webpage\"},\"dateModified\":\"2026-09-14T12:00:04.158Z\",\"publisher\":{\"@id\":\"https://docs.creem.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.creem.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Creem\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Creem","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/q3GKZs92Av"},{"anchor":"Blog","icon":"newspaper","href":"https://creem.io/blog"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"Ship Software. Get Paid Globally.","href":"/getting-started/introduction"},{"title":"Quickstart","href":"/getting-started/quickstart"},{"title":"Test Mode","href":"/getting-started/test-mode"},{"group":"Account Reviews","pages":[{"title":"Account Reviews","href":"/merchant-of-record/account-reviews/account-reviews"},{"title":"How to Request a Re-Review","href":"/merchant-of-record/account-reviews/re-review-guide"},{"title":"If your account was rejected","href":"/merchant-of-record/account-reviews/rejected-accounts"},{"title":"AI Wrapper Compliance","href":"/merchant-of-record/account-reviews/ai-wrapper-compliance"}]},{"title":"Dashboard Overview","href":"/getting-started/dashboard-overview"},{"title":"Migrate to Creem","href":"/getting-started/migrate"}]},{"group":"AI","icon":"robot","pages":[{"title":"AI Integration","href":"/ai/introduction"},{"group":"For Humans","pages":[{"title":"Getting Started","href":"/ai/for-humans/getting-started"},{"title":"Creem CLI","href":"/ai/for-humans/cli"}]},{"group":"For Agents","pages":[{"title":"Skill Files","href":"/ai/for-agents/skill-files"},{"title":"MCP Server","href":"/ai/for-agents/mcp-server"},{"title":"Creem CLI","href":"/ai/for-agents/cli"},{"title":"Store Monitoring","href":"/ai/for-agents/store-monitoring"}]}]},{"group":"Features","icon":"sparkles","pages":[{"group":"Checkout","pages":[{"title":"Checkout API","href":"/features/checkout/checkout-api"},{"title":"Checkout Link","href":"/features/checkout/checkout-link"},{"title":"Embedded Checkout","href":"/features/checkout/embedded-checkout"},{"title":"Checkout Customization","href":"/features/checkout/checkout-customization"},{"title":"Checkout Custom Fields","href":"/features/checkout/checkout-custom-fields"},{"title":"Checkout Localization","href":"/features/checkout/checkout-localization"}]},{"title":"One Time Payments","href":"/features/one-time-payment"},{"title":"Pay What You Want","href":"/features/pay-what-you-want"},{"group":"Subscriptions","pages":[{"title":"Subscriptions","href":"/features/subscriptions/introduction"},{"title":"Managing Subscriptions","href":"/features/subscriptions/managing"},{"title":"Refunds and Cancellations","href":"/features/subscriptions/refunds-and-cancellations"}]},{"title":"Seat Based Billing","href":"/features/seat-based-billing"},{"title":"Revenue Splits","href":"/features/split-payments"},{"title":"Affiliate Program","sidebarTitle":"Affiliate Program","href":"/features/affiliate-program"},{"title":"Referral Program","sidebarTitle":"Referral Program","href":"/features/referral-program"},{"title":"Storefronts","href":"/features/storefronts"},{"title":"Custom Domains","href":"/features/custom-domains"},{"title":"Short Links","href":"/features/short-links"},{"title":"Discount Codes","href":"/features/discounts"},{"title":"Trials","href":"/features/trials"},{"title":"Customer Portal","href":"/features/customer-portal"},{"title":"Product Bundles","href":"/features/product-bundles"},{"title":"Moderation","href":"/features/moderation"},{"title":"Usage-Based Billing","href":"/features/usage-based-billing"},{"group":"Customer Credits","pages":[{"title":"Customer Credits","sidebarTitle":"Introduction","href":"/features/customer-credits/introduction"},{"title":"Accounts","href":"/features/customer-credits/accounts"},{"title":"Transactions","href":"/features/customer-credits/transactions"},{"title":"Auto-refill","href":"/features/customer-credits/auto-refill"}]},{"group":"Events","pages":[{"title":"Ingest usage events","openapi":"post /v1/events/ingest","href":"/api-reference/endpoint/ingest-usage-events"},{"title":"Preview usage events","openapi":"post /v1/events/preview","href":"/api-reference/endpoint/preview-usage-events"},{"title":"List usage events","openapi":"get /v1/events","href":"/api-reference/endpoint/list-usage-events"}]},{"group":"Meters","pages":[{"title":"Create a meter","openapi":"post /v1/meters","href":"/api-reference/endpoint/create-meter"},{"title":"List meters","openapi":"get /v1/meters","href":"/api-reference/endpoint/list-meters"},{"title":"Retrieve a meter","openapi":"get /v1/meters/{id}","href":"/api-reference/endpoint/get-meter"},{"title":"Update a meter","openapi":"patch /v1/meters/{id}","href":"/api-reference/endpoint/update-meter"},{"title":"Preview an unsaved meter definition","description":"Dry-run a candidate meter definition against your real usage over the last 7 whole UTC days (today included, future-dated events excluded) WITHOUT creating anything: matched events, aggregated units, distinct customers, and a zero-filled per-day series, oldest first. Useful for checking a definition before committing to it. The scan is capped defensively and runs newest-first, so a very high-volume store gets the most recent slice of the window rather than an unbounded scan — the recent days stay complete and the oldest day of the series degrades.","openapi":"post /v1/meters/preview","href":"/api-reference/endpoint/preview-meter"},{"title":"Preview an existing meter","openapi":"post /v1/meters/{id}/preview","href":"/api-reference/endpoint/preview-existing-meter"},{"title":"Get consumed units for a customer","description":"How many units a customer has consumed through this meter in a billing period, alongside the period's boundaries. Without `at`, this is an O(1) read of the current period's projection — the number billing uses. With `at`, the units are replayed from the raw events as of that instant, within the billing period containing it, which is the right call for reconstructing what a customer had consumed at a past moment (an invoice date, a support question).","openapi":"get /v1/meters/{id}/consumed","href":"/api-reference/endpoint/get-meter-consumed-units"},{"title":"Archive a meter","openapi":"post /v1/meters/{id}/archive","href":"/api-reference/endpoint/archive-meter"},{"title":"Unarchive a meter","openapi":"post /v1/meters/{id}/unarchive","href":"/api-reference/endpoint/unarchive-meter"}]},{"group":"Addons","pages":[{"title":"License Keys","href":"/features/addons/licenses"},{"title":"Private Notes","href":"/features/addons/private-notes"},{"title":"File Downloads","href":"/features/addons/file-downloads"},{"title":"Abandoned Cart Recovery","href":"/features/addons/abandoned-cart-recovery"}]}]},{"group":"Code","icon":"code","pages":[{"group":"SDKs","pages":[{"title":"TypeScript","href":"/code/sdks/typescript"},{"title":"Next.js adapter","href":"/code/sdks/nextjs"},{"group":"Better Auth","pages":[{"title":"Overview","href":"/code/sdks/better-auth"},{"title":"Quickstart","href":"/code/sdks/better-auth/quickstart"},{"title":"Configuration","href":"/code/sdks/better-auth/configuration"},{"title":"Client API","href":"/code/sdks/better-auth/client"},{"title":"Webhooks and access","href":"/code/sdks/better-auth/webhooks"},{"title":"Server API","href":"/code/sdks/better-auth/server"},{"title":"Migration","href":"/code/sdks/better-auth/migration"}]},{"group":"Convex","pages":[{"title":"Quickstart","href":"/code/sdks/convex/quickstart"},{"title":"Concepts","href":"/code/sdks/convex/concepts"},{"title":"Subscriptions","href":"/code/sdks/convex/subscriptions"},{"title":"One-Time Products \u0026 Credits","href":"/code/sdks/convex/one-time-and-credits"},{"title":"Entitlements \u0026 Account UI","href":"/code/sdks/convex/entitlements"},{"title":"Advanced","href":"/code/sdks/convex/advanced"},{"title":"Migration","href":"/code/sdks/convex/migration"},{"title":"Component Reference","href":"/code/sdks/convex/reference"}]},{"title":"Creem Next.js Template","href":"/code/sdks/templates"},{"title":"AI Agents","href":"/code/sdks/ai-agents"}]},{"title":"Creem CLI","href":"/code/cli"},{"title":"Webhooks","href":"/code/webhooks"}]},{"group":"Integrations","icon":"link","pages":[{"group":"Affiliate programs","pages":[{"title":"Affonso Affiliate Program Integration","sidebarTitle":"Affonso","href":"/integrations/affonso"},{"title":"LinkJolt Affiliate Program Integration","sidebarTitle":"LinkJolt","href":"/integrations/linkjolt"},{"title":"Referly Affiliate Program Integration","sidebarTitle":"Referly","href":"/integrations/referly"},{"title":"Refgrow Affiliate Program Integration","sidebarTitle":"Refgrow","href":"/integrations/refgrow"},{"title":"Rekomi Affiliate Program Integration","sidebarTitle":"Rekomi","href":"/integrations/rekomi"}]},{"title":"Evendeals","href":"/integrations/evendeals"},{"title":"Framer","href":"/integrations/framer"},{"title":"Strapi","href":"/integrations/strapi"}]},{"group":"Community","icon":"users","pages":[{"title":"Community Resources","href":"/code/community/community-resources"}]},{"group":"Merchant of Record","icon":"building","pages":[{"title":"What is a Merchant of Record","href":"/merchant-of-record/what-is"},{"title":"Supported Countries","href":"/merchant-of-record/supported-countries"},{"group":"Finance","pages":[{"title":"Payouts","href":"/merchant-of-record/finance/payouts"},{"title":"Payout Accounts","href":"/merchant-of-record/finance/payout-accounts"},{"title":"Refunds and Chargebacks","href":"/merchant-of-record/finance/refunds-and-chargebacks"},{"title":"Payments","href":"/merchant-of-record/finance/payment-methods"}]}]},{"group":"For Customers","icon":"circle-question","pages":[{"title":"Why did Creem charge me","href":"/for-customers/why-creem-charged-me"},{"title":"How to cancel a subscription","href":"/for-customers/how-to-cancel-subscription"},{"title":"How to update payment method","href":"/for-customers/how-to-update-payment-method"},{"title":"I can't log in to the Customer Portal","href":"/for-customers/cant-log-in-to-customer-portal"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"title":"Preview an existing meter - Creem","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}