Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.
Send Authorization: Bearer <THRED_API_KEY>. Development keys begin thr_dev_; Production keys begin thr_prod_. Each key is scoped to a workspace and environment. Keep secrets on your server.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Thred API","description":"The data API for the phone. Collect structured answers from a known phone number.","colors":{"primary":"#3AA4C1","light":"#3AA4C1","dark":"#3AA4C1"},"logo":{"light":"https://mintcdn.com/pop101/o-sRhnCnjLqfHGe3/images/logo_full_dark.png?fit=max\u0026auto=format\u0026n=o-sRhnCnjLqfHGe3\u0026q=85\u0026s=acd9058a2fc6c122b1b200877b0d36dd","dark":"https://mintcdn.com/pop101/o-sRhnCnjLqfHGe3/images/logo_full_light.png?fit=max\u0026auto=format\u0026n=o-sRhnCnjLqfHGe3\u0026q=85\u0026s=0be4abc5d471e6db0953d7c9e3b887e9"},"favicon":"https://mintcdn.com/pop101/xEyEjyZgrjRp9yCI/images/icon.ico?fit=max\u0026auto=format\u0026n=xEyEjyZgrjRp9yCI\u0026q=85\u0026s=47086c9a22642a088551ba9129637e16","api":{"openapi":"api-reference/openapi.json","playground":{"display":"simple"},"examples":{"defaults":"required","languages":["curl","javascript","python"]}},"background":{"color":{"light":"#FFFFFF","dark":"#1D1D1D"}},"navbar":{"links":[{"href":"https://thred.ai","label":"Website"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.thred.ai"}},"fonts":{"family":"Instrument Sans"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pop101","hasAudioNarration":false,"actualSubdomain":"pop101","customDomains":["www.thred.dev"],"gitSource":{"type":"github","owner":"thred-ai","repo":"thred-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6ae4efc5a50e0154d4d48983"},"chroma":{"liveDeploymentHistoryId":"6ae55ed1e88570d4b4a37508","collectionId":"9be77499-6eb5-4df6-b65e-673214645ee6","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae55ed1e88570d4b4a37508"},"entitlements":{},"buildId":"6ae55fc913db368f60c3eff7","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Collect API","count":5},{"language":"default","tag":"Account and utilities","count":3},{"language":"default","tag":"Get started","count":3}]},"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":"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":"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":"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":"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}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--thred-surface:#ffffff;--thred-muted-surface:#f2f2f2;--thred-text:#2b333b;--thred-secondary-text:#717989;--thred-border:#dcdcdc;--thred-panel-border:#f0f0f0;--thred-hover:#f3f3f3;--thred-accent:#3aa4c1;--thred-link:#0957d0;--sidebar-width:14rem;--content-width:48rem}.dark{--thred-surface:#1d1d1d;--thred-muted-surface:#303030;--thred-text:lch(77.594 1 139.088);--thred-secondary-text:lch(67.594 1 139.088);--thred-border:#414141;--thred-panel-border:#2d2d2d;--thred-hover:#2a2a2a;--thred-link:#8ab4f8}body{font-size:14px;letter-spacing:calc(.6px - .05em);-webkit-font-smoothing:antialiased}button,input,select,textarea{font-family:inherit}#mobile-nav,#mobile-nav-content,#navbar,#navbar-transition{background:var(--thred-surface);border-color:var(--thred-panel-border)}img.nav-logo{height:28px!important;width:auto!important}#page-title,body{color:var(--thred-text)}#page-title{font-size:24px;font-weight:600;line-height:32px;letter-spacing:-.025em}#header .eyebrow,#header>div{color:var(--thred-secondary-text)}#header .eyebrow{font-size:12px;font-weight:500}#header>div{font-size:14px;line-height:24px}:is(#content, #api-playground-2-operation-page){margin-top:28px}#api-playground-2-operation-page,#content-container .prose{color:var(--thred-text);font-size:14px;line-height:24px;--tw-prose-body:var(--thred-text);--tw-prose-headings:var(--thred-text);--tw-prose-bold:var(--thred-text);--tw-prose-links:var(--thred-link);--tw-prose-counters:var(--thred-secondary-text);--tw-prose-bullets:var(--thred-secondary-text);--tw-prose-code:var(--thred-text);--tw-prose-th-borders:var(--thred-border);--tw-prose-td-borders:var(--thred-panel-border)}:is(#content, #api-playground-2-operation-page) :is(h2, h3, h4){color:var(--thred-text);font-weight:600;letter-spacing:calc(.6px - .05em)}:is(#content, #api-playground-2-operation-page) h2{font-size:18px;line-height:28px;margin-top:32px;margin-bottom:12px}:is(#content, #api-playground-2-operation-page) h3,:is(#content, #api-playground-2-operation-page) h4{font-size:14px;line-height:24px}:is(#content, #api-playground-2-operation-page) :is(p, ul, ol){margin-top:12px;margin-bottom:12px}:is(#content, #api-playground-2-operation-page) strong{color:var(--thred-text);font-weight:600}:is(#content, #api-playground-2-operation-page) a:not(.card):not([aria-label]){color:var(--thred-link);text-decoration-thickness:1px;text-underline-offset:3px}#mobile-nav-content a,#sidebar a{color:var(--thred-text);font-size:14px;font-weight:400;border-radius:6px}#mobile-nav-content a:hover,#sidebar a:hover{background:var(--thred-hover)}#mobile-nav-content .sidebar-group a[class~=\"bg-primary/10\"],#sidebar .sidebar-group a[class~=\"bg-primary/10\"]{color:var(--thred-text);background:var(--thred-muted-surface);font-weight:500;text-shadow:none}#sidebar-title{color:var(--thred-secondary-text);font-size:12px;font-weight:500}#footer,#table-of-contents,#table-of-contents a,.navbar-link{color:var(--thred-secondary-text);font-size:13px}#table-of-contents a:hover{color:var(--thred-text)}#search-bar-entry,#topbar-cta-button a{border-radius:6px;font-size:13px;box-shadow:none}#search-bar-entry{height:32px;border:1px solid var(--thred-border);background:var(--thred-surface);color:var(--thred-secondary-text);filter:none}#topbar-cta-button a{min-height:28px;padding:4px 10px;border:1px solid var(--thred-accent);background:color-mix(in srgb,var(--thred-accent) 80%,transparent);color:#2b333b;font-weight:400}#topbar-cta-button a:hover{background:color-mix(in srgb,var(--thred-accent) 60%,transparent)}#topbar-cta-button a>span{background:0 0;border-radius:inherit}#topbar-cta-button a :is(span, svg){color:inherit}.card{border:1px solid var(--thred-border);border-radius:6px;background:var(--thred-surface);box-shadow:none}.card:hover{border-color:var(--thred-border)!important;background:var(--thred-hover)}[data-component-part=card-content-container]{padding:16px}[data-component-part=card-icon]{width:20px;height:20px;color:var(--thred-accent);fill:var(--thred-accent)}:is(#content, #api-playground-2-operation-page) [data-component-part=card-title]{color:var(--thred-text);font-size:14px;line-height:24px;margin-top:12px;margin-bottom:4px}[data-component-part=card-content]{color:var(--thred-secondary-text);font-size:14px;line-height:24px}:is(#content, #api-playground-2-operation-page) table{width:100%;font-size:14px;line-height:24px}:is(#content, #api-playground-2-operation-page) td,:is(#content, #api-playground-2-operation-page) th{padding:8px 12px;border-bottom:1px solid var(--thred-panel-border)}:is(#content, #api-playground-2-operation-page) th{background:var(--thred-muted-surface);color:var(--thred-secondary-text);font-size:12px;font-weight:500}:is(#content, #api-playground-2-operation-page) .callout{border:1px solid var(--thred-border);border-radius:6px;background:var(--thred-muted-surface);color:var(--thred-text);font-size:14px;line-height:24px}:is(#content, #api-playground-2-operation-page) [data-component-part=callout-content]{color:var(--thred-text);line-height:24px}:is(#content, #api-playground-2-operation-page) [data-component-part=callout-icon] svg{color:var(--thred-secondary-text)}.code-block,.code-group{border:1px solid var(--thred-border);border-radius:8px;box-shadow:none}#content-container .code-block-background{background:var(--thred-surface)!important;border-radius:inherit}code,kbd,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,\"Liberation Mono\",\"Courier New\",monospace;letter-spacing:0}pre,pre code{font-size:13px;line-height:24px}:is(#content, #api-playground-2-operation-page) :not(pre)>code{background:var(--thred-muted-surface);color:var(--thred-text);border-color:var(--thred-border);border-radius:4px;font-size:12px}#pagination a,.expandable,.option-dropdown{border-color:var(--thred-border);border-radius:6px}@media (min-width:1024px){#sidebar{width:var(--sidebar-width)}#sidebar-content{padding-right:12px}#content-area{padding-left:calc(var(--sidebar-width) + 6rem)}}a:focus-visible,button:focus-visible,input:focus-visible{outline:2px solid var(--thred-link);outline-offset:3px}"}],"page":{"pagePath":"api-reference/get-usage","slug":"/api-reference/get-usage","pageMetadata":{"title":"Get usage","openapi":"api-reference/openapi.json GET /v1/usage","description":"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.","href":"/api-reference/get-usage"},"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: \"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.\"\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":"Get usage","openapi":"api-reference/openapi.json GET /v1/usage","description":"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.","href":"/api-reference/get-usage"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getUsage","tags":["Usage"],"summary":"Get daily usage","description":"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.","parameters":["a15e7e20-9f12-48cf-9908-9980e4e4a3d2","f4aad107-ad6c-4537-a502-8a3c7d6c3e64"],"responses":{"200":"f5a3584f-89e2-4be1-b450-2e366a958ceb","400":"7ce45f32-d15b-4e12-86fa-a9afe335f445","401":"e211c0c1-60f7-4035-8b8b-0be091590985","500":"bcc9c5a2-04a7-4737-ba3f-3e6d9147285d","503":"d3987ef1-2984-4c17-82e0-9f78c9fcaee9"},"method":"get","type":"path","servers":["018fa0c6-8491-4098-bf8a-ea0196732702"],"security":["169d90c7-fab1-4290-a28c-41b56a1ae8f2"],"path":"/v1/usage","baseUrlOptions":["https://api.thred.dev"],"title":"Get daily usage","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a15e7e20-9f12-48cf-9908-9980e4e4a3d2":{"name":"from","in":"query","description":"First UTC date, inclusive. Defaults to today.","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First UTC date, inclusive. Defaults to today.","uniqueKey":"","typeLabel":"string\u003cdate>"},"example":"2026-10-30"},"f4aad107-ad6c-4537-a502-8a3c7d6c3e64":{"name":"to","in":"query","description":"Last UTC date, inclusive. Must be on or after from and no more than 30 days later. Defaults to today.","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last UTC date, inclusive. Must be on or after from and no more than 30 days later. Defaults to today.","uniqueKey":"","typeLabel":"string\u003cdate>"},"example":"2026-10-30"}},"responses":{"f5a3584f-89e2-4be1-b450-2e366a958ceb":{"description":"Daily operational usage for the selected API environment.","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","format":"date","isRequired":true,"uniqueKey":"from","typeLabel":"string\u003cdate>"},"to":{"type":"string","format":"date","isRequired":true,"uniqueKey":"to","typeLabel":"string\u003cdate>"},"environment":{"type":"string","enum":["development","production"],"description":"The API key selects the workspace environment. Development and Production are isolated, but either can place real calls when enabled.","isRequired":true,"uniqueKey":"environment","typeLabel":"enum\u003cstring>"},"timezone":{"type":"string","enum":["UTC"],"isRequired":true,"uniqueKey":"timezone","typeLabel":"enum\u003cstring>"},"attribution":{"type":"string","enum":["call_created_date"],"isRequired":true,"uniqueKey":"attribution","typeLabel":"enum\u003cstring>"},"billing_status":{"type":"string","enum":["unreconciled"],"isRequired":true,"uniqueKey":"billing_status","typeLabel":"enum\u003cstring>"},"billed_seconds":{"oneOf":[{"type":"number","enum":[null],"description":"Always null; these counters are not billing reconciliation.","isRequired":true,"uniqueKey":"billed_seconds.oneOf.0","typeLabel":"enum\u003cnumber>"},{"type":"null","enum":[null],"description":"Always null; these counters are not billing reconciliation.","isRequired":true,"uniqueKey":"billed_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"billed_seconds","typeLabel":"enum\u003cnumber> | null"},"data":{"type":"array","minItems":1,"maxItems":31,"items":{"type":"object","properties":{"day":{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.items.[INDEX].day","typeLabel":"string\u003cdate>"},"requested":{"type":"integer","minimum":0,"description":"Accepted collections, counted once. Idempotent replays do not increment this count.","isRequired":true,"uniqueKey":"data.items.[INDEX].requested","typeLabel":"integer"},"completed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].completed","typeLabel":"integer"},"incomplete":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete","typeLabel":"integer"},"failed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].failed","typeLabel":"integer"},"canceled":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].canceled","typeLabel":"integer"},"human_assisted":{"type":"integer","minimum":0,"description":"Finalized collections that had live human assistance.","isRequired":true,"uniqueKey":"data.items.[INDEX].human_assisted","typeLabel":"integer"},"elapsed_job_seconds":{"type":"number","minimum":0,"description":"Operational elapsed duration recorded on physical call closure.","isRequired":true,"uniqueKey":"data.items.[INDEX].elapsed_job_seconds","typeLabel":"number"}},"required":["day","requested","completed","incomplete","failed","canceled","human_assisted","elapsed_job_seconds"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["from","to","environment","timezone","attribution","billing_status","billed_seconds","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"from":"2023-12-25","to":"2023-12-25","environment":"development","timezone":"UTC","attribution":"call_created_date","billing_status":"unreconciled","billed_seconds":null,"data":[{"day":"2023-12-25","requested":1,"completed":1,"incomplete":1,"failed":1,"canceled":1,"human_assisted":1,"elapsed_job_seconds":1}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7ce45f32-d15b-4e12-86fa-a9afe335f445":{"description":"Invalid request, schema, destination, duration, caller number, webhook, or date range. Inspect error.code and error.message.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e211c0c1-60f7-4035-8b8b-0be091590985":{"description":"Missing, malformed, invalid, revoked, or environment-mismatched bearer API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"bcc9c5a2-04a7-4737-ba3f-3e6d9147285d":{"description":"Unexpected server error.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d3987ef1-2984-4c17-82e0-9f78c9fcaee9":{"description":"Calling or the backend is unavailable. Codes include calling_unavailable, environment_unavailable, not_configured, and backend_unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"169d90c7-fab1-4290-a28c-41b56a1ae8f2":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Thred API key","description":"Send Authorization: Bearer \u003cTHRED_API_KEY>. Development keys begin thr_dev_; Production keys begin thr_prod_. Each key is scoped to a workspace and environment. Keep secrets on your server.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"018fa0c6-8491-4098-bf8a-ea0196732702":{"url":"https://api.thred.dev","description":"Thred API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Thred API key","description":"Send Authorization: Bearer \u003cTHRED_API_KEY>. Development keys begin thr_dev_; Production keys begin thr_prod_. Each key is scoped to a workspace and environment. Keep secrets on your server.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send Authorization: Bearer \u003cTHRED_API_KEY>. Development keys begin thr_dev_; Production keys begin thr_prod_. Each key is scoped to a workspace and environment. Keep secrets on your server.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"pop101","siteName":"Thred API","title":"Get usage - Thred API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T19:40:36.456Z","originalFileLocation":"api-reference/get-usage.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=\"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Thred API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pop101/j0nmZA184tfqmqT0/_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/pop101/j0nmZA184tfqmqT0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pop101/j0nmZA184tfqmqT0/_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/pop101/j0nmZA184tfqmqT0/_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/pop101/j0nmZA184tfqmqT0/_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/pop101/j0nmZA184tfqmqT0/_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/pop101/j0nmZA184tfqmqT0/_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/pop101/j0nmZA184tfqmqT0/_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/pop101/j0nmZA184tfqmqT0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get usage - Thred API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Thred API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.thred.dev/api-reference/get-usage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pop101.mintlify.app/_mintlify/api/og/v2?division=Account+and+utilities\u0026amp;title=Get+usage\u0026amp;description=Read+daily+collection+counts+and+elapsed+job+seconds+for+1%E2%80%9331+inclusive+UTC+days.+Both+dates+default+to+today.+Usage+is+attributed+to+the+collection%E2%80%99s+creation+\u0026amp;theme=d17339659d3ab7261c0da2d6\u0026amp;signature=a7856f688530da6125c3dec4f1a78dd2e2729ee39fdbc8bc9ccf28fe6fcc4c75\">\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=\"Get usage - Thred API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pop101.mintlify.app/_mintlify/api/og/v2?division=Account+and+utilities\u0026amp;title=Get+usage\u0026amp;description=Read+daily+collection+counts+and+elapsed+job+seconds+for+1%E2%80%9331+inclusive+UTC+days.+Both+dates+default+to+today.+Usage+is+attributed+to+the+collection%E2%80%99s+creation+\u0026amp;theme=d17339659d3ab7261c0da2d6\u0026amp;signature=a7856f688530da6125c3dec4f1a78dd2e2729ee39fdbc8bc9ccf28fe6fcc4c75\">\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/pop101/j0nmZA184tfqmqT0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Thred API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3AA4C1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.thred.dev/api-reference/get-usage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-usage.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.thred.dev/#organization\",\"name\":\"Thred API\",\"url\":\"https://www.thred.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pop101/o-sRhnCnjLqfHGe3/images/logo_full_dark.png?fit=max\u0026auto=format\u0026n=o-sRhnCnjLqfHGe3\u0026q=85\u0026s=acd9058a2fc6c122b1b200877b0d36dd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.thred.dev#website\",\"name\":\"Thred API\",\"url\":\"https://www.thred.dev\",\"publisher\":{\"@id\":\"https://www.thred.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.thred.dev/api-reference/get-usage#webpage\",\"url\":\"https://www.thred.dev/api-reference/get-usage\",\"name\":\"Get usage\",\"description\":\"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.\",\"dateModified\":\"2026-10-30T19:40:36.456Z\",\"isPartOf\":{\"@id\":\"https://www.thred.dev#website\"},\"breadcrumb\":{\"@id\":\"https://www.thred.dev/api-reference/get-usage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.thred.dev/api-reference/get-usage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Account and utilities\",\"item\":\"https://www.thred.dev/api-reference/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get usage\",\"item\":\"https://www.thred.dev/api-reference/get-usage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.thred.dev/api-reference/get-usage#apireference\",\"headline\":\"Get usage\",\"name\":\"Get usage\",\"description\":\"Read daily collection counts and elapsed job seconds for 1–31 inclusive UTC days. Both dates default to today. Usage is attributed to the collection’s creation date and is not a billing statement.\",\"url\":\"https://www.thred.dev/api-reference/get-usage\",\"mainEntityOfPage\":{\"@id\":\"https://www.thred.dev/api-reference/get-usage#webpage\"},\"dateModified\":\"2026-10-30T19:40:36.456Z\",\"publisher\":{\"@id\":\"https://www.thred.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://www.thred.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Thred API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Thred API","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Thred API","icon":"phone","href":"/introduction"},{"title":"Quickstart","icon":"bolt","href":"/quickstart"},{"title":"What you can build","href":"/guides/what-you-can-build"}]},{"group":"Collect API","pages":[{"title":"Create a collection","openapi":"api-reference/openapi.json POST /v1/collect","href":"/api-reference/create-collection"},{"title":"Get a collection","openapi":"api-reference/openapi.json GET /v1/collect/{id}","href":"/api-reference/get-collection"},{"title":"List collections","openapi":"api-reference/openapi.json GET /v1/collect","href":"/api-reference/list-collections"},{"title":"Cancel a collection","openapi":"api-reference/openapi.json POST /v1/collect/{id}/cancel","href":"/api-reference/cancel-collection"},{"title":"Get a recording","openapi":"api-reference/openapi.json GET /v1/collect/{id}/recording","href":"/api-reference/get-recording"}]},{"group":"Account and utilities","pages":[{"title":"Check your API key","openapi":"api-reference/openapi.json GET /v1/auth/me","description":"Check your key and see its workspace and environment.","href":"/api-reference/authentication"},{"title":"Get usage","openapi":"api-reference/openapi.json GET /v1/usage","href":"/api-reference/get-usage"},{"title":"Check API health","openapi":"api-reference/openapi.json GET /v1/health","description":"Check whether the API service responds. No API key is needed.","href":"/api-reference/health"}]}]},"basePath":"","title":"Get usage - Thred API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}