{
"error": {
"code": "INVALID_FILTER",
"message": "One or more filters are not valid.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
{
"error": {
"code": "API_KEY_INVALID",
"message": "The API key is not valid.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
{
"error": {
"code": "API_KEY_SCOPE_REQUIRED",
"message": "The API key does not have the required permission.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "The requested resource was not found.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
{
"error": {
"code": "INVALID_FILTER",
"message": "One or more filters are not valid.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
{
"error": {
"code": "API_KEY_INVALID",
"message": "The API key is not valid.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
{
"error": {
"code": "API_KEY_SCOPE_REQUIRED",
"message": "The API key does not have the required permission.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "The requested resource was not found.",
"requestId": "7a39da10-819c-4db4-9dcf-f27d48e3a7c0"
}
}
Use this route for runtime variables, field filters, a timezone, or refresh: true. Filters run
after joins and dataset transformations.Variables and source refreshes require the Refresh data from sources key permission.
Runtime variable values. The default limit is 100 keys, 10 nested levels, and 8192 bytes per string. Variable names proto, constructor, and prototype are not accepted.
Joined and transformed dataset value. It can be an array, object, scalar, or null.
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Chartbrew Docs","colors":{"primary":"#048BDE","light":"#048BDE","dark":"#048BDE"},"logo":{"light":"https://mintcdn.com/chartbrew/0NOw1Ayq_SxHOzrD/logo/cb_logo_black.svg?fit=max\u0026auto=format\u0026n=0NOw1Ayq_SxHOzrD\u0026q=85\u0026s=3024a993202614eb42a5c8a5b2aec8fd","dark":"https://mintcdn.com/chartbrew/0NOw1Ayq_SxHOzrD/logo/cb_logo_white.svg?fit=max\u0026auto=format\u0026n=0NOw1Ayq_SxHOzrD\u0026q=85\u0026s=aa2da3b58a34c7a58fea1102149777c2"},"favicon":"https://mintcdn.com/chartbrew/YPArDehzXjtype0O/favicon.png?fit=max\u0026auto=format\u0026n=YPArDehzXjtype0O\u0026q=85\u0026s=3d8d07bd5c4cf5be4811910caa27cd44","api":{"playground":{"display":"interactive","proxy":false},"mdx":{"server":"http://localhost:4021"}},"navbar":{"links":[{"href":"https://github.com/chartbrew/chartbrew/issues","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.chartbrew.com"}},"footer":{"socials":{"x":"https://x.com/chartbrew","github":"https://github.com/chartbrew","linkedin":"https://linkedin.com/company/chartbrew"}},"seo":{"metatags":{"title":"Chartbrew Docs","og:title":"Chartbrew Docs","description":"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.","og:description":"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.","og:type":"website","og:image":"https://cdn2.chartbrew.com/banners/MainOG.png","og:url":"https://docs.chartbrew.com","twitter:card":"summary_large_image","twitter:title":"Chartbrew Docs","twitter:description":"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.","twitter:image":"https://cdn2.chartbrew.com/banners/MainOG.png","twitter:site":"@chartbrew"},"indexing":"navigable"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://chartbrew.com"},{"anchor":"Community","icon":"Discord","href":"https://discord.gg/KwGEbFk"},{"anchor":"Blog","icon":"newspaper","href":"https://chartbrew.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/chartbrew/chartbrew"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chartbrew","hasAudioNarration":false,"actualSubdomain":"chartbrew","customDomains":["docs.chartbrew.com"],"gitSource":{"type":"github","owner":"chartbrew","repo":"chartbrew-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a8624fbc2199ff39d93f174","collectionId":"313dfd8a-fff2-42ee-b83d-e5f68d6d0589","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a8624fbc2199ff39d93f174"},"entitlements":{},"buildId":"6ae815efbb3a1948dee708c6","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":60},{"language":"default","tag":"Documentation","count":22},{"language":"default","tag":"Charts","count":13},{"language":"default","tag":"Dashboards","count":10},{"language":"default","tag":"Connections","count":8},{"language":"default","tag":"Datasets","count":8},{"language":"default","tag":"Deployment","count":8},{"language":"default","tag":"Data Requests","count":7},{"language":"default","tag":"Chart-Dataset Configs","count":4},{"language":"default","tag":"Data API","count":4}]},"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},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/endpoint/data-api/query-dataset-data","slug":"/api-reference/endpoint/data-api/query-dataset-data","pageMetadata":{"title":"Query dataset data","description":"Read dataset data with variables, field filters, or a source refresh.","openapi":"POST /api/v1/teams/{team_id}/datasets/{dataset_id}/data","href":"/api-reference/endpoint/data-api/query-dataset-data"},"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 dataset data with variables, field filters, or a source refresh.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this route for runtime variables, field filters, a timezone, or `,_jsx(_components.code,{children:`refresh: true`}),`. Filters run\nafter joins and dataset transformations.`]}),`\n`,_jsxs(_components.p,{children:[`Variables and source refreshes require the `,_jsx(_components.strong,{children:`Refresh data from sources`}),` key permission.`]})]})}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":"Query dataset data","description":"Read dataset data with variables, field filters, or a source refresh.","openapi":"POST /api/v1/teams/{team_id}/datasets/{dataset_id}/data","href":"/api-reference/endpoint/data-api/query-dataset-data"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Query dataset data","description":"Read dataset data with variables, field filters, or a source refresh.","operationId":"queryDatasetDataV1","tags":["Data API"],"security":["5e03bd1e-066c-4576-bfdb-de5d6ee68bc2"],"parameters":["16faa8a5-e839-47a2-b9e7-124ffec104aa","3794c4b8-04ee-4cce-ad67-15bec66e7c91"],"requestBody":"426bae48-7980-4852-bafb-e58e6b66301b","responses":{"200":"afd241f0-49ad-4f82-97ca-3b6f38667f58","400":"4d2ad558-9aad-4d98-86fd-6bd5c1f76149","401":"1fdf2e74-7111-4d11-8ccf-c3ac055881fc","403":"b5295329-e170-41ae-a7b5-3fef6e3c0e90","404":"397623a0-b5cf-4438-86f9-90587c2a6412","406":"56ef1424-5db6-4643-a030-740e6fc0e064","413":"23d9d74d-3cea-4eb6-9ce0-73b1c9aca420","415":"e0dcaf3a-2d1e-45c6-9c67-5852972a4c37","429":"940e94a8-92d9-4a3f-bf9b-82f8dbd70228","500":"aa6e1017-b627-44ba-9f0a-c175276b1de6","503":"905da36e-d628-43d2-b0bc-9bc9e46b50ae","504":"070c0ab0-d3f0-4110-84ec-83833bb4c84b"},"method":"post","type":"path","servers":["2fd09360-46b3-487c-aec9-66d90ebb01ff"],"path":"/api/v1/teams/{team_id}/datasets/{dataset_id}/data","baseUrlOptions":["https://api.chartbrew.com"],"title":"Query dataset data","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"16faa8a5-e839-47a2-b9e7-124ffec104aa":{"name":"team_id","in":"path","required":true,"description":"Positive team ID bound to the API key.","schema":{"type":"integer","minimum":1,"isRequired":true,"description":"Positive team ID bound to the API key.","uniqueKey":"","typeLabel":"integer"}},"3794c4b8-04ee-4cce-ad67-15bec66e7c91":{"name":"dataset_id","in":"path","required":true,"description":"Positive dataset ID.","schema":{"type":"integer","minimum":1,"isRequired":true,"description":"Positive dataset ID.","uniqueKey":"","typeLabel":"integer"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"variables":{"type":"object","description":"Runtime variable values. The default limit is 100 keys, 10 nested levels, and 8192 bytes per string. Variable names __proto__, constructor, and prototype are not accepted.","maxProperties":100,"additionalProperties":{"oneOf":[{}],"uniqueKey":"variables.additionalProperties","typeLabel":"any"},"uniqueKey":"variables","typeLabel":"object"},"filters":{"type":"array","maxItems":50,"description":"Chart-wide field filters. Date and chart dataset configuration scopes are not accepted.","items":{"type":"object","additionalProperties":false,"required":["field","operator"],"properties":{"field":{"type":"string","minLength":1,"description":"Dataset field path, such as root[].status. Dataset filters must identify one array collection.","isRequired":true,"uniqueKey":"filters.items.[INDEX].field","typeLabel":"string"},"operator":{"type":"string","enum":["is","isNot","contains","notContains","greaterThan","greaterOrEqual","lessThan","lessOrEqual","isNull","isNotNull"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["field"],"default":"field","uniqueKey":"filters.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"description":"JSON comparison value. It is optional for isNull and isNotNull.","uniqueKey":"filters.items.[INDEX].value.oneOf.0","typeLabel":"any"},{"description":"JSON comparison value. It is optional for isNull and isNotNull.","type":"null","uniqueKey":"filters.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.items.[INDEX].value","typeLabel":"any | null"},"scope":{"type":"string","enum":["chart","cdc"],"uniqueKey":"filters.items.[INDEX].scope","typeLabel":"enum\u003cstring>"},"cdcId":{"oneOf":[{"type":"integer","description":"Chart dataset configuration ID. Use only with chart cdc scope.","minimum":1,"uniqueKey":"filters.items.[INDEX].cdcId.oneOf.0","typeLabel":"integer"},{"type":"string","description":"Chart dataset configuration ID. Use only with chart cdc scope.","pattern":"^[1-9]\\d*$","uniqueKey":"filters.items.[INDEX].cdcId.oneOf.1","typeLabel":"string"}],"uniqueKey":"filters.items.[INDEX].cdcId","typeLabel":"integer | string"},"forceSourceRefresh":{"type":"boolean","default":false,"uniqueKey":"filters.items.[INDEX].forceSourceRefresh","typeLabel":"boolean"}},"uniqueKey":"filters.items.[INDEX]","typeLabel":"object"},"default":[],"uniqueKey":"filters","typeLabel":"object[]"},"refresh":{"type":"boolean","default":false,"uniqueKey":"refresh","typeLabel":"boolean"},"timezone":{"type":"string","description":"IANA timezone used for dataset field comparisons.","default":"UTC","example":"Asia/Bangkok","uniqueKey":"timezone","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"variables":{"region":"APAC"},"filters":[{"type":"field","field":"root[].amount","operator":"greaterOrEqual","value":100}],"refresh":false,"timezone":"Asia/Bangkok"},"examples":{"Example":{"title":"Example","value":{"variables":{"region":"APAC"},"filters":[{"type":"field","field":"root[].amount","operator":"greaterOrEqual","value":100}],"refresh":false,"timezone":"Asia/Bangkok"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"afd241f0-49ad-4f82-97ca-3b6f38667f58":{"description":"Joined and transformed dataset data.","headers":{"ETag":{"description":"Content identity returned for GET responses. Generation time is not part of this value.","schema":{"type":"string","example":"\"pd-v1-0123456789abcdef\""}},"Last-Modified":{"description":"Generation time in HTTP date format.","schema":{"type":"string","example":"Tue, 25 Aug 2026 08:00:00 GMT"}},"X-Chartbrew-Data-Stale":{"description":"True when Chartbrew returns the last known result while source data is stale.","schema":{"type":"boolean","example":false}}},"content":{"application/json":{"schema":{"type":"object","required":["version","generatedAt","resource","fields","data"],"properties":{"version":{"type":"integer","enum":[1],"isRequired":true,"uniqueKey":"version","typeLabel":"enum\u003cinteger>"},"generatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"generatedAt","typeLabel":"string\u003cdate-time>"},"resource":{"type":"object","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["chart","dataset"],"isRequired":true,"uniqueKey":"resource.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"integer","isRequired":true,"uniqueKey":"resource.id","typeLabel":"integer"},"name":{"oneOf":[{"type":"string","uniqueKey":"resource.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"resource.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"resource.name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"resource","typeLabel":"object"},"fields":{"type":"array","items":{"type":"object","required":["key","type"],"properties":{"key":{"type":"string","example":"root[].amount","isRequired":true,"uniqueKey":"fields.items.[INDEX].key","typeLabel":"string"},"type":{"type":"string","enum":["number","date","string","boolean","array","object","unknown"],"isRequired":true,"uniqueKey":"fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"fields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"fields","typeLabel":"object[]"},"data":{"oneOf":[{"description":"Joined and transformed dataset value. It can be an array, object, scalar, or null.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Joined and transformed dataset value. It can be an array, object, scalar, or null.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"version":1,"generatedAt":"2026-08-25T08:00:00.000Z","resource":{"kind":"dataset","id":18,"name":"Orders"},"fields":[{"key":"root[].amount","type":"number"},{"key":"root[].customer.name","type":"string"}],"data":[{"amount":120,"customer":{"name":"Ada"}}]},"examples":{"Example":{"title":"Example","value":{"version":1,"generatedAt":"2026-08-25T08:00:00.000Z","resource":{"kind":"dataset","id":18,"name":"Orders"},"fields":[{"key":"root[].amount","type":"number"},{"key":"root[].customer.name","type":"string"}],"data":[{"amount":120,"customer":{"name":"Ada"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"4d2ad558-9aad-4d98-86fd-6bd5c1f76149":{"description":"The ID, body, variable, filter, or JSON shape is not valid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INVALID_FILTER","message":"One or more filters are not valid.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_FILTER","message":"One or more filters are not valid.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}}}},"exampleType":"examples"}},"exampleType":"examples"},"1fdf2e74-7111-4d11-8ccf-c3ac055881fc":{"description":"The Data API bearer key is missing or invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"API_KEY_INVALID","message":"The API key is not valid.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"API_KEY_INVALID","message":"The API key is not valid.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}}}},"exampleType":"examples"}},"exampleType":"examples"},"b5295329-e170-41ae-a7b5-3fef6e3c0e90":{"description":"The key does not have read or refresh permission.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"API_KEY_SCOPE_REQUIRED","message":"The API key does not have the required permission.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"API_KEY_SCOPE_REQUIRED","message":"The API key does not have the required permission.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}}}},"exampleType":"examples"}},"exampleType":"examples"},"397623a0-b5cf-4438-86f9-90587c2a6412":{"description":"The resource is missing, outside key access, or under another parent.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"RESOURCE_NOT_FOUND","message":"The requested resource was not found.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"RESOURCE_NOT_FOUND","message":"The requested resource was not found.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}}}},"exampleType":"examples"}},"exampleType":"examples"},"56ef1424-5db6-4643-a030-740e6fc0e064":{"description":"The client does not accept JSON.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"\u003cstring>","requestId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"23d9d74d-3cea-4eb6-9ce0-73b1c9aca420":{"description":"The request exceeds 65536 bytes by default, or the complete response exceeds 5242880 bytes by default.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"\u003cstring>","requestId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e0dcaf3a-2d1e-45c6-9c67-5852972a4c37":{"description":"The POST body is not application/json.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"\u003cstring>","requestId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"940e94a8-92d9-4a3f-bf9b-82f8dbd70228":{"description":"The default limit is 60 requests per API key per minute or 30 failed authentication attempts per IP per minute.","headers":{"Retry-After":{"description":"Seconds to wait before another request.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"RATE_LIMITED","message":"Too many requests were sent. Try again later.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"RATE_LIMITED","message":"Too many requests were sent. Try again later.","requestId":"7a39da10-819c-4db4-9dcf-f27d48e3a7c0"}}}},"exampleType":"examples"}},"exampleType":"examples"},"aa6e1017-b627-44ba-9f0a-c175276b1de6":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"\u003cstring>","requestId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"905da36e-d628-43d2-b0bc-9bc9e46b50ae":{"description":"No saved result is usable and the source cannot supply data.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"\u003cstring>","requestId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"070c0ab0-d3f0-4110-84ec-83833bb4c84b":{"description":"The request exceeded the default 30000 millisecond execution limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_VARIABLE","INVALID_FILTER","API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_SCOPE_REQUIRED","RESOURCE_NOT_FOUND","NOT_ACCEPTABLE","REQUEST_TOO_LARGE","RESPONSE_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","RATE_LIMITED","INTERNAL_ERROR","DATA_UNAVAILABLE","EXECUTION_TIMEOUT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"\u003cstring>","requestId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5e03bd1e-066c-4576-bfdb-de5d6ee68bc2":{"dataApiBearer":{"type":"http","scheme":"bearer","bearerFormat":"Chartbrew API key","description":"A database-bound Data API key created in Team settings. Session and share tokens are not accepted.","scopes":[],"schemeName":"dataApiBearer"}}},"servers":{"2fd09360-46b3-487c-aec9-66d90ebb01ff":{"url":"https://api.chartbrew.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Chartbrew API key","description":"A database-bound Data API key created in Team settings. Session and share tokens are not accepted.","scopes":[],"schemeName":"dataApiBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A database-bound Data API key created in Team settings. Session and share tokens are not accepted.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"dataApiBearer","name":"Authorization"}],"title":"dataApiBearer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"chartbrew","siteName":"Chartbrew Docs","title":"Chartbrew Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T04:47:49.246Z","originalFileLocation":"api-reference/endpoint/data-api/query-dataset-data.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 dataset data with variables, field filters, or a source refresh.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cdn2.chartbrew.com/banners/MainOG.png\">\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=\"Chartbrew Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cdn2.chartbrew.com/banners/MainOG.png\">\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/chartbrew/TDgfP0iapcicMV_Z/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#048BDE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data\">\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/data-api/query-dataset-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.chartbrew.com/#organization\",\"name\":\"Chartbrew Docs\",\"url\":\"https://docs.chartbrew.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chartbrew/0NOw1Ayq_SxHOzrD/logo/cb_logo_black.svg?fit=max\u0026auto=format\u0026n=0NOw1Ayq_SxHOzrD\u0026q=85\u0026s=3024a993202614eb42a5c8a5b2aec8fd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.chartbrew.com#website\",\"name\":\"Chartbrew Docs\",\"url\":\"https://docs.chartbrew.com\",\"publisher\":{\"@id\":\"https://docs.chartbrew.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data#webpage\",\"url\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data\",\"name\":\"Query dataset data\",\"description\":\"Read dataset data with variables, field filters, or a source refresh.\",\"dateModified\":\"2026-11-02T04:47:49.246Z\",\"isPartOf\":{\"@id\":\"https://docs.chartbrew.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Data API\",\"item\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/get-dataset-data\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Query dataset data\",\"item\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data#apireference\",\"headline\":\"Query dataset data\",\"name\":\"Query dataset data\",\"description\":\"Read dataset data with variables, field filters, or a source refresh.\",\"url\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/data-api/query-dataset-data#webpage\"},\"image\":\"https://cdn2.chartbrew.com/banners/MainOG.png\",\"dateModified\":\"2026-11-02T04:47:49.246Z\",\"publisher\":{\"@id\":\"https://docs.chartbrew.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.chartbrew.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chartbrew Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Chartbrew Docs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://chartbrew.com"},{"anchor":"Community","icon":"Discord","href":"https://discord.gg/KwGEbFk"},{"anchor":"Blog","icon":"newspaper","href":"https://chartbrew.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/chartbrew/chartbrew"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Guides","pages":[{"title":"Create a chart from scratch","href":"/api-reference/guides/create-chart"},{"title":"Use the Data API","href":"/api-reference/guides/data-api"}]},{"group":"Data API","pages":[{"title":"Get dataset data","description":"Read the current joined and transformed result for a dataset.","openapi":"GET /api/v1/teams/{team_id}/datasets/{dataset_id}/data","href":"/api-reference/endpoint/data-api/get-dataset-data"},{"title":"Query dataset data","openapi":"POST /api/v1/teams/{team_id}/datasets/{dataset_id}/data","href":"/api-reference/endpoint/data-api/query-dataset-data"},{"title":"Get chart data","description":"Read the current renderer-neutral rows prepared for a chart.","openapi":"GET /api/v1/projects/{project_id}/charts/{chart_id}/data","href":"/api-reference/endpoint/data-api/get-chart-data"},{"title":"Query chart data","openapi":"POST /api/v1/projects/{project_id}/charts/{chart_id}/data","href":"/api-reference/endpoint/data-api/query-chart-data"}]},{"group":"Teams","pages":[{"title":"Get Team","openapi":"GET /team/{team_id}","href":"/api-reference/endpoint/team/get"},{"title":"Create Team","openapi":"POST /team","href":"/api-reference/endpoint/team/create"},{"title":"Get User Teams","openapi":"GET /team","href":"/api-reference/endpoint/team/get-user-teams"},{"title":"Update Team","openapi":"PUT /team/{team_id}","href":"/api-reference/endpoint/team/update"}]},{"group":"Dashboards","pages":[{"title":"What is a Dashboard?","href":"/api-reference/endpoint/dashboards/info"},{"title":"Get a dashboard","openapi":"GET /project/{id}","href":"/api-reference/endpoint/dashboards/get"},{"title":"List all dashboards","openapi":"GET /project/team/{team_id}","href":"/api-reference/endpoint/dashboards/list"},{"title":"Create a dashboard","openapi":"POST /project","href":"/api-reference/endpoint/dashboards/create"},{"title":"Update a Dashboard","openapi":"PUT /project/{id}","href":"/api-reference/endpoint/dashboards/update"},{"title":"Delete a dashboard","openapi":"DELETE /project/{id}","href":"/api-reference/endpoint/dashboards/delete"},{"title":"Create Dashboard Share Policy","openapi":"POST /project/{id}/share/policy","href":"/api-reference/endpoint/dashboards/create-share-policy"},{"title":"Update Dashboard Share Policy","openapi":"PUT /project/{id}/share/policy/{policy_id}","href":"/api-reference/endpoint/dashboards/update-share-policy"},{"title":"Delete Dashboard Share Policy","openapi":"DELETE /project/{id}/share/policy/{policy_id}","href":"/api-reference/endpoint/dashboards/delete-share-policy"},{"title":"Generate Dashboard Share Token","openapi":"POST /project/{id}/share/token","href":"/api-reference/endpoint/dashboards/generate-share-token"}]},{"group":"Connections","pages":[{"title":"What is a Connection?","href":"/api-reference/endpoint/connections/info"},{"title":"List connections","openapi":"GET /team/{team_id}/connections","href":"/api-reference/endpoint/connections/list"},{"title":"Get a connection","openapi":"GET /team/{team_id}/connections/{connection_id}","href":"/api-reference/endpoint/connections/get"},{"title":"Create a connection","openapi":"POST /team/{team_id}/connections","href":"/api-reference/endpoint/connections/create"},{"title":"Update a connection","openapi":"PUT /team/{team_id}/connections/{connection_id}","href":"/api-reference/endpoint/connections/update"},{"title":"Delete a connection","openapi":"DELETE /team/{team_id}/connections/{connection_id}","href":"/api-reference/endpoint/connections/delete"},{"title":"Update connection files","openapi":"POST /team/{team_id}/connections/{connection_id}/files","href":"/api-reference/endpoint/connections/update-files"},{"title":"Test a connection","openapi":"GET /team/{team_id}/connections/{connection_id}/test","href":"/api-reference/endpoint/connections/test"}]},{"group":"Datasets","pages":[{"title":"What is a Dataset?","href":"/api-reference/endpoint/datasets/info"},{"title":"List datasets","openapi":"GET /team/{team_id}/datasets","href":"/api-reference/endpoint/datasets/list"},{"title":"Get a dataset","openapi":"GET /team/{team_id}/datasets/{dataset_id}","href":"/api-reference/endpoint/datasets/get"},{"title":"Quick Create","openapi":"POST /team/{team_id}/datasets/quick-create","href":"/api-reference/endpoint/datasets/quick-create"},{"title":"Create a dataset","openapi":"POST /team/{team_id}/datasets","href":"/api-reference/endpoint/datasets/create"},{"title":"Update a dataset","openapi":"PUT /team/{team_id}/datasets/{dataset_id}","href":"/api-reference/endpoint/datasets/update"},{"title":"Delete a dataset","openapi":"DELETE /team/{team_id}/datasets/{dataset_id}","href":"/api-reference/endpoint/datasets/delete"},{"title":"Fetch dataset data","openapi":"GET /team/{team_id}/datasets/{dataset_id}/request","href":"/api-reference/endpoint/datasets/fetch-dataset-data"}]},{"group":"Data Requests","pages":[{"title":"What is a Data Request?","href":"/api-reference/endpoint/datarequests/info"},{"title":"Create a Data Request","openapi":"POST /team/{team_id}/datasets/{dataset_id}/dataRequests","href":"/api-reference/endpoint/datarequests/create"},{"title":"Get Dataset Data Requests","openapi":"GET /team/{team_id}/datasets/{dataset_id}/dataRequests","href":"/api-reference/endpoint/datarequests/list"},{"title":"Update a Data Request","openapi":"PUT /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}","href":"/api-reference/endpoint/datarequests/update"},{"title":"Run a Data Request","openapi":"POST /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}/request","href":"/api-reference/endpoint/datarequests/run"},{"title":"Create a Variable Binding","openapi":"POST /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}/variableBindings","href":"/api-reference/endpoint/datarequests/create-variablebinding"},{"title":"Update a Variable Binding","openapi":"PUT /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}/variableBindings/{variable_id}","href":"/api-reference/endpoint/datarequests/update-variablebinding"}]},{"group":"Charts","pages":[{"title":"What is a Chart?","href":"/api-reference/endpoint/charts/info"},{"title":"Get a chart","openapi":"GET /project/{project_id}/chart/{id}","href":"/api-reference/endpoint/charts/get"},{"title":"Quick Create Chart","openapi":"POST /project/{project_id}/chart/quick-create","href":"/api-reference/endpoint/charts/quick-create"},{"title":"Create a chart","openapi":"POST /project/{project_id}/chart","href":"/api-reference/endpoint/charts/create"},{"title":"Query a chart","openapi":"POST /project/{project_id}/chart/{id}/query","href":"/api-reference/endpoint/charts/query"},{"title":"Render chart image","openapi":"POST /project/{project_id}/chart/{chart_id}/image","href":"/api-reference/endpoint/charts/render-image"},{"title":"Delete a chart","openapi":"DELETE /project/{project_id}/chart/{id}","href":"/api-reference/endpoint/charts/delete"},{"title":"Get Chart for Sharing","openapi":"GET /chart/share/{share_string}","href":"/api-reference/endpoint/charts/share-chart"},{"title":"Create Chart Share Policy","openapi":"POST /project/{project_id}/chart/{id}/share/policy","href":"/api-reference/endpoint/charts/create-share-policy"},{"title":"Update Chart Share Policy","openapi":"PUT /project/{project_id}/chart/{chart_id}/share/policy/{policy_id}","href":"/api-reference/endpoint/charts/update-chart-share-policy"},{"title":"Delete Chart Share Policy","openapi":"DELETE /project/{project_id}/chart/{chart_id}/share/policy/{policy_id}","href":"/api-reference/endpoint/charts/delete-chart-share-policy"},{"title":"Generate Chart Share Token","openapi":"POST /project/{project_id}/chart/{id}/share/token","href":"/api-reference/endpoint/charts/generate-share-token"}]},{"group":"Chart-Dataset Configs","pages":[{"title":"What is a Chart-Dataset Config?","href":"/api-reference/endpoint/chartdatasetconfigs/info"},{"title":"Create a chart config","openapi":"POST /project/{project_id}/chart/{id}/chart-dataset-config","href":"/api-reference/endpoint/chartdatasetconfigs/create"},{"title":"Update a chart config","openapi":"PUT /project/{project_id}/chart/{id}/chart-dataset-config/{cdc_id}","href":"/api-reference/endpoint/chartdatasetconfigs/update"},{"title":"Delete a chart config","openapi":"DELETE /project/{project_id}/chart/{id}/chart-dataset-config/{cdc_id}","href":"/api-reference/endpoint/chartdatasetconfigs/delete"}]}]}]},"basePath":"","title":"Chartbrew Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}