Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the before cursor with the created_at of the last entry you saw to page backward.
GET
/
credits
/
history
Get token usage history
curl --request GET \ --url https://api-service.fribl.co/api/v1/credits/history \ --header 'x-api-key: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fribl","colors":{"primary":"#0054FF","light":"#3D7AFF","dark":"#001F5E"},"logo":{"light":"https://mintcdn.com/fribl/238CQHJXtNN2WOY2/logo/light.svg?fit=max\u0026auto=format\u0026n=238CQHJXtNN2WOY2\u0026q=85\u0026s=69969e880dd07463d0de413da9098506","dark":"https://mintcdn.com/fribl/238CQHJXtNN2WOY2/logo/dark.svg?fit=max\u0026auto=format\u0026n=238CQHJXtNN2WOY2\u0026q=85\u0026s=2345b0bb16efad0b28c3c9d074de5ca4","href":"https://fribl.co"},"favicon":"https://mintcdn.com/fribl/238CQHJXtNN2WOY2/favicon.svg?fit=max\u0026auto=format\u0026n=238CQHJXtNN2WOY2\u0026q=85\u0026s=3de828410be69490f143b028078e0a22","api":{"openapi":"api-reference/openapi.json","playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript","go","java"]}},"appearance":{"default":"dark","strict":true},"background":{"color":{"dark":"#000F2D"}},"navbar":{"links":[{"href":"https://fribl.co","label":"Website"}],"primary":{"type":"button","label":"Console","href":"https://console.fribl.co"}},"footer":{"socials":{"website":"https://fribl.co"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fribl","hasAudioNarration":false,"actualSubdomain":"fribl","customDomains":["docs.fribl.co"],"gitSource":{"type":"github","owner":"nexusbridge","repo":"fribl-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a6a2e9311a80bbe482eb360","collectionId":"b3014684-bc49-4f28-9d14-53962126050f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a6a2e9311a80bbe482eb360"},"entitlements":{},"buildId":"6ae94835bf5f6a4758f2197b:success","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"Documentation","count":7},{"language":"default","tag":"CVs","count":7},{"language":"default","tag":"Jobs","count":7},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Tokens","count":3},{"language":"default","tag":"Guides","count":2},{"language":"default","tag":"Matching","count":2},{"language":"default","tag":"Skills","count":2},{"language":"default","tag":"Sourcing","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tokens/get-token-usage-history","slug":"/api-reference/tokens/get-token-usage-history","pageMetadata":{"title":"Get token usage history","description":"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the `before` cursor with the `created_at` of the last entry you saw to page backward.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /credits/history","href":"/api-reference/tokens/get-token-usage-history","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the \", _jsx(_components.code, {\n children: \"before\"\n }), \" cursor with the \", _jsx(_components.code, {\n children: \"created_at\"\n }), \" of the last entry you saw to page backward.\"]\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 token usage history","description":"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the `before` cursor with the `created_at` of the last entry you saw to page backward.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /credits/history","href":"/api-reference/tokens/get-token-usage-history","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getTokenHistory","summary":"Get token usage history","description":"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the `before` cursor with the `created_at` of the last entry you saw to page backward.","tags":["Tokens"],"parameters":["ebc400ad-5948-4c7b-a5cf-4272d1f2b354","87cf296a-3ff3-4510-8cf3-4f3bf8f3d3fb"],"responses":{"200":"45d1e2e7-519f-4fab-86e8-50cdb90bd80f","401":"d6ea7617-b646-4923-b529-4b42fad12e54"},"method":"get","type":"path","servers":["20865e4f-5385-4137-abc8-a61b5521d8dd"],"security":["84b8d8ce-97de-4d06-a5db-df83160928a0"],"path":"/credits/history","baseUrlOptions":["https://api-service.fribl.co/api/v1"],"title":"Get token usage history","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go","java"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ebc400ad-5948-4c7b-a5cf-4272d1f2b354":{"name":"limit","in":"query","description":"Maximum number of ledger entries to return.","required":false,"schema":{"type":"integer","default":50,"minimum":1,"maximum":500,"isRequired":false,"description":"Maximum number of ledger entries to return.","uniqueKey":"","typeLabel":"integer"}},"87cf296a-3ff3-4510-8cf3-4f3bf8f3d3fb":{"name":"before","in":"query","description":"Return only entries created strictly before this ISO 8601 timestamp. Use for backward pagination.","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"description":"Return only entries created strictly before this ISO 8601 timestamp. Use for backward pagination.","uniqueKey":"","typeLabel":"string\u003cdate-time>"}}},"responses":{"45d1e2e7-519f-4fab-86e8-50cdb90bd80f":{"description":"Ledger entries, newest first.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A single immutable token movement. Charges are negative; refunds and grants are positive.","properties":{"id":{"type":"string","description":"Ledger entry identifier.","example":"10472","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"workspace_id":{"type":"string","example":"ws_a1b2c3d4","isRequired":true,"uniqueKey":"data.items.[INDEX].workspace_id","typeLabel":"string"},"action":{"type":"string","description":"Billable action (e.g. `cv_processing`) or a balance event such as `grant` or `token_expired`. A positive amount on a billable action is a refund of a prior charge.","example":"cv_processing","isRequired":true,"uniqueKey":"data.items.[INDEX].action","typeLabel":"string"},"amount":{"type":"integer","description":"Signed token change. Negative for a charge, positive for a refund or grant.","example":-1,"isRequired":true,"uniqueKey":"data.items.[INDEX].amount","typeLabel":"integer"},"balance_after":{"type":"string","description":"Balance immediately after this entry was applied.","example":"151","isRequired":true,"uniqueKey":"data.items.[INDEX].balance_after","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","example":"2026-06-03T10:15:30.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"reference_id":{"oneOf":[{"type":"string","description":"Task, match, or session this entry is tied to.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"data.items.[INDEX].reference_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Task, match, or session this entry is tied to.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"data.items.[INDEX].reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].reference_id","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","description":"Optional structured context, such as a refund reason.","uniqueKey":"data.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Optional structured context, such as a refund reason.","uniqueKey":"data.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].metadata","typeLabel":"object | null"}},"required":["id","workspace_id","action","amount","balance_after","created_at"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"10472","workspace_id":"ws_a1b2c3d4","action":"cv_processing","amount":-1,"balance_after":"151","created_at":"2026-06-03T10:15:30.000Z","reference_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","metadata":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d6ea7617-b646-4923-b529-4b42fad12e54":{"description":"Authentication failed. Provide a valid API key in the `x-api-key` header.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response.","properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"84b8d8ce-97de-4d06-a5db-df83160928a0":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key in UUID format. Include this header with every authenticated request.","scopes":[]}}},"servers":{"20865e4f-5385-4137-abc8-a61b5521d8dd":{"url":"https://api-service.fribl.co/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key in UUID format. Include this header with every authenticated request.","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key in UUID format. Include this header with every authenticated request.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"fribl","siteName":"Fribl","title":"Get token usage history - Fribl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-28T13:33:33.748Z","originalFileLocation":"api-reference/tokens/get-token-usage-history.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the before cursor with the created_at of the last entry you saw to page backward.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fribl\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fribl/CahCorpOh8G1i9MB/_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/fribl/CahCorpOh8G1i9MB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fribl/CahCorpOh8G1i9MB/_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/fribl/CahCorpOh8G1i9MB/_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/fribl/CahCorpOh8G1i9MB/_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/fribl/CahCorpOh8G1i9MB/_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/fribl/CahCorpOh8G1i9MB/_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/fribl/CahCorpOh8G1i9MB/_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/fribl/CahCorpOh8G1i9MB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get token usage history - Fribl\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the before cursor with the created_at of the last entry you saw to page backward.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fribl\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fribl.mintlify.app/_mintlify/api/og/v2?division=Tokens\u0026amp;title=Get+token+usage+history\u0026amp;description=Return+a+paginated+ledger+of+every+token+movement+for+your+workspace+%E2%80%94+charges%2C+refunds%2C+grants%2C+and+expirations+%E2%80%94+ordered+newest+first.+Use+the+%60before%60+cursor\u0026amp;theme=baf84cb4b946a5c21c298fa7\u0026amp;signature=2798f95725bee70a6b8880454fba87cd95de3b95fa2cb1ac4c9d0369bf264947\">\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 token usage history - Fribl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the before cursor with the created_at of the last entry you saw to page backward.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fribl.mintlify.app/_mintlify/api/og/v2?division=Tokens\u0026amp;title=Get+token+usage+history\u0026amp;description=Return+a+paginated+ledger+of+every+token+movement+for+your+workspace+%E2%80%94+charges%2C+refunds%2C+grants%2C+and+expirations+%E2%80%94+ordered+newest+first.+Use+the+%60before%60+cursor\u0026amp;theme=baf84cb4b946a5c21c298fa7\u0026amp;signature=2798f95725bee70a6b8880454fba87cd95de3b95fa2cb1ac4c9d0369bf264947\">\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/fribl/CahCorpOh8G1i9MB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fribl\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0054FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tokens/get-token-usage-history.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fribl.co/#organization\",\"name\":\"Fribl\",\"url\":\"https://docs.fribl.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fribl/238CQHJXtNN2WOY2/logo/light.svg?fit=max\u0026auto=format\u0026n=238CQHJXtNN2WOY2\u0026q=85\u0026s=69969e880dd07463d0de413da9098506\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fribl.co#website\",\"name\":\"Fribl\",\"url\":\"https://docs.fribl.co\",\"publisher\":{\"@id\":\"https://docs.fribl.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history#webpage\",\"url\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history\",\"name\":\"Get token usage history\",\"description\":\"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the before cursor with the created_at of the last entry you saw to page backward.\",\"dateModified\":\"2026-07-28T13:33:33.748Z\",\"isPartOf\":{\"@id\":\"https://docs.fribl.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tokens\",\"item\":\"https://docs.fribl.co/api-reference/tokens/get-token-balance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get token usage history\",\"item\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history#apireference\",\"headline\":\"Get token usage history\",\"name\":\"Get token usage history\",\"description\":\"Return a paginated ledger of every token movement for your workspace — charges, refunds, grants, and expirations — ordered newest first. Use the before cursor with the created_at of the last entry you saw to page backward.\",\"url\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fribl.co/api-reference/tokens/get-token-usage-history#webpage\"},\"dateModified\":\"2026-07-28T13:33:33.748Z\",\"publisher\":{\"@id\":\"https://docs.fribl.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fribl.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fribl\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fribl","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Sourcing","icon":"magnifying-glass","pages":[{"title":"Search candidate profiles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /sourcing/search","href":"/api-reference/sourcing/search-candidate-profiles"},{"title":"Ingest candidate profiles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /sourcing/ingest","href":"/api-reference/sourcing/ingest-candidate-profiles"}]},{"group":"CVs","icon":"file-user","pages":[{"title":"Analyze CV from text","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cvs/analyze","href":"/api-reference/cvs/analyze-cv-from-text"},{"title":"Analyze CV from file upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cvs/analyze/files","href":"/api-reference/cvs/analyze-cv-from-file-upload"},{"title":"Check CV processing status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cvs/status","href":"/api-reference/cvs/check-cv-processing-status"},{"title":"List all CVs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /cvs","href":"/api-reference/cvs/list-all-cvs"},{"title":"Get CV by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /cvs/{id}","href":"/api-reference/cvs/get-cv-by-id"},{"title":"Update a CV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /cvs/{id}","href":"/api-reference/cvs/update-a-cv"},{"title":"Delete a CV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /cvs/{id}","href":"/api-reference/cvs/delete-a-cv"}]},{"group":"Jobs","icon":"briefcase","pages":[{"title":"Analyze job from text","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /jobs/analyze","href":"/api-reference/jobs/analyze-job-from-text"},{"title":"Analyze job from file upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /jobs/analyze/files","href":"/api-reference/jobs/analyze-job-from-file-upload"},{"title":"Check job processing status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /jobs/status","href":"/api-reference/jobs/check-job-processing-status"},{"title":"List all jobs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /jobs","href":"/api-reference/jobs/list-all-jobs"},{"title":"Get job by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /jobs/{id}","href":"/api-reference/jobs/get-job-by-id"},{"title":"Update a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /jobs/{id}","href":"/api-reference/jobs/update-a-job"},{"title":"Delete a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /jobs/{id}","href":"/api-reference/jobs/delete-a-job"}]},{"group":"Matching","icon":"arrows-rotate","pages":[{"title":"Match CVs to a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /match","href":"/api-reference/matching/match-cvs-to-a-job"},{"title":"Get match results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /match/{jobId}","href":"/api-reference/matching/get-match-results"}]},{"group":"Skills","icon":"lightbulb","pages":[{"title":"Search skills","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /skills/search","href":"/api-reference/skills/search-skills"},{"title":"Get available languages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /skills/languages","href":"/api-reference/skills/get-available-languages"}]},{"group":"Tokens","icon":"wallet","pages":[{"title":"Get token balance","description":"Return the real-time token balance for the workspace the API key belongs to. All keys in a workspace share one balance.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /credits/balance","href":"/api-reference/tokens/get-token-balance"},{"title":"Get token usage history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /credits/history","href":"/api-reference/tokens/get-token-usage-history"},{"title":"Get the token price list","description":"Return the current price in tokens for every billable action. This is the authoritative pricing source — build cost estimates against it rather than hardcoding values.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /credits/costs","href":"/api-reference/tokens/get-the-token-price-list"}]}]}]},"basePath":"","title":"Get token usage history - Fribl","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}