Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"GEOly Docs","colors":{"primary":"#0A0A0A","light":"#FAFAFA","dark":"#0A0A0A"},"logo":{"light":"https://mintcdn.com/ge-oly/Cn9GPNuGnA715ktI/logo/light.svg?fit=max\u0026auto=format\u0026n=Cn9GPNuGnA715ktI\u0026q=85\u0026s=d3cea28520cc9660b9bd70ab642920fe","dark":"https://mintcdn.com/ge-oly/Cn9GPNuGnA715ktI/logo/dark.svg?fit=max\u0026auto=format\u0026n=Cn9GPNuGnA715ktI\u0026q=85\u0026s=27331f9b0a5bcd18013b345d305edbcd","href":"https://www.geoly.ai"},"favicon":"https://mintcdn.com/ge-oly/Cn9GPNuGnA715ktI/favicon.png?fit=max\u0026auto=format\u0026n=Cn9GPNuGnA715ktI\u0026q=85\u0026s=357b47b037719a7aee6ea367a758d2e2","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"navbar":{"links":[{"href":"https://www.geoly.ai/blog","label":"Blog"},{"href":"https://www.geoly.ai/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Sign in","href":"https://app.geoly.ai"}},"footer":{"socials":{"website":"https://www.geoly.ai"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ge-oly","hasAudioNarration":false,"actualSubdomain":"ge-oly","customDomains":["docs.geoly.ai"],"gitSource":{"type":"github","owner":"geoly-ai","repo":"geoly-web-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6ae8442a0b211b76a285b925"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae8637e3630049289fe671b","collectionId":"7b03849a-937f-4c9a-8d6f-3a2946910f66","liveDeploymentHistoryId":"6ae8637e3630049289fe671b","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae868924729f9837cf157d2","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"zh","tag":"文档","count":20},{"language":"en","tag":"Documentation","count":15},{"language":"zh","tag":"洞察","count":6},{"language":"en","tag":"Insights","count":3},{"language":"en","tag":"MCP Server","count":3},{"language":"en","tag":"Get started","count":3},{"language":"en","tag":"Shopify app","count":3},{"language":"zh","tag":"监测","count":3},{"language":"zh","tag":"MCP Server","count":3},{"language":"zh","tag":"入门","count":3},{"language":"zh","tag":"Shopify 应用","count":3},{"language":"en","tag":"Monitoring","count":2},{"language":"en","tag":"Integrations","count":2},{"language":"zh","tag":"集成","count":2},{"language":"en","tag":"CLI","count":1},{"language":"en","tag":"API Reference","count":1},{"language":"en","tag":"Data API","count":1},{"language":"zh","tag":"CLI","count":1},{"language":"zh","tag":"API Reference","count":1},{"language":"zh","tag":"Data API","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":false},"customCss":[],"page":{"pagePath":"api-reference/records/list-prompt-records","slug":"/api-reference/records/list-prompt-records","pageMetadata":{"title":"List prompt records","openapi":"api-reference/openapi.json GET /api/v1/prompts/{prompt_id}/records","description":"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.","href":"/api-reference/records/list-prompt-records"},"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: \"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.\"\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":"List prompt records","openapi":"api-reference/openapi.json GET /api/v1/prompts/{prompt_id}/records","description":"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.","href":"/api-reference/records/list-prompt-records"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listPromptRecords","summary":"Monitoring records of one prompt","description":"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.","tags":["Records"],"security":["62255991-e1ad-4b3b-bf92-71e13392d4f3"],"x-geoly-stability":"stable","x-geoly-cost":{"tier":"light","base":1,"unit":"call","long_window_multiplier":2,"guard_rpm":null},"x-geoly-required-permission":"prompt:read","x-geoly-pagination":{"style":"cursor","max_position":10000,"limit_param":"limit","max_limit":200,"cursor_param":"cursor","next_cursor_path":"$.page.next_cursor"},"x-speakeasy-pagination":{"type":"cursor","inputs":[{"name":"cursor","in":"parameters","type":"cursor"}],"outputs":{"nextCursor":"$.page.next_cursor"}},"parameters":["50352e47-c48b-473a-8137-a218462ea456","7e2db43d-bb9c-45d6-b024-2bb6264ec492","6bdbb73a-60d6-4e66-b50c-275edb43b248","e4b590f9-7622-45c3-9f49-c5dbaa341e6b","5e6c299e-45f3-41a7-8ffa-effa88d3fa71","4033cb95-12c8-462a-874b-923359da4694","111211fc-c63e-4739-9f2c-8cd89c261a2f","c1e2b506-fe5c-4ad9-8549-e479d7147239"],"responses":{"200":"d36fd586-0086-4ac1-a92d-16d8d88ee884","400":"299a88c3-cd32-4f9c-84ff-f1389cf20684","401":"8d6da85e-4819-410c-b472-d24fa65047b3","402":"f930b272-726d-49d3-9d1b-8cb4d791adce","403":"c7a03b9a-f958-433d-b084-ae721da636b0","404":"2f6bbcef-3873-4cb3-a35c-b7dd6b082435","429":"dacbfb70-eda4-44ca-94fe-cbd8f5ed2bfc","500":"96e7c137-07e9-4c88-969e-29748f3c39b2","503":"2f760f9c-752c-4ee2-b0e0-123e3f68f8d9"},"method":"get","type":"path","servers":["ff9899c6-8f8e-4cb4-84f4-02cccd12d5a4"],"path":"/api/v1/prompts/{prompt_id}/records","baseUrlOptions":["https://app.geoly.ai"],"title":"Monitoring records of one prompt","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"50352e47-c48b-473a-8137-a218462ea456":{"name":"prompt_id","in":"path","required":true,"description":"Resource id for this API key brand.","schema":{"type":"string","minLength":1,"maxLength":64,"isRequired":true,"description":"Resource id for this API key brand.","uniqueKey":"","typeLabel":"string"}},"7e2db43d-bb9c-45d6-b024-2bb6264ec492":{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":200,"isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"6bdbb73a-60d6-4e66-b50c-275edb43b248":{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"isRequired":false,"uniqueKey":"","typeLabel":"string"}},"e4b590f9-7622-45c3-9f49-c5dbaa341e6b":{"name":"time_range","in":"query","required":false,"schema":{"default":"30d","type":"string","enum":["7d","30d","90d"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"5e6c299e-45f3-41a7-8ffa-effa88d3fa71":{"name":"start_date","in":"query","required":false,"description":"First business day; send with end_date (UTC+8 business day, YYYY-MM-DD).","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","isRequired":false,"description":"First business day; send with end_date (UTC+8 business day, YYYY-MM-DD).","uniqueKey":"","typeLabel":"string"}},"4033cb95-12c8-462a-874b-923359da4694":{"name":"end_date","in":"query","required":false,"description":"Last business day inclusive; maximum 366 days (UTC+8 business day, YYYY-MM-DD).","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","isRequired":false,"description":"Last business day inclusive; maximum 366 days (UTC+8 business day, YYYY-MM-DD).","uniqueKey":"","typeLabel":"string"}},"111211fc-c63e-4739-9f2c-8cd89c261a2f":{"name":"platform","in":"query","required":false,"schema":{"default":"all","type":"string","enum":["all","chatgpt","perplexity","gemini","google_ai","copilot","google_ai_overview"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"c1e2b506-fe5c-4ad9-8549-e479d7147239":{"name":"sort_order","in":"query","required":false,"description":"Record-day order. Offset pagination is not a snapshot; inserts or deletes can shift pages even in ascending order. Deduplicate by id.","schema":{"default":"desc","type":"string","enum":["asc","desc"],"isRequired":false,"description":"Record-day order. Offset pagination is not a snapshot; inserts or deletes can shift pages even in ascending order. Deduplicate by id.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"d36fd586-0086-4ac1-a92d-16d8d88ee884":{"description":"Monitoring records of one prompt. `data` follows PromptRecordList when meta.schema_conformant is true.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].id","typeLabel":"string"},"platform_code":{"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].platform_code","typeLabel":"string"},"platform_name":{"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].platform_name","typeLabel":"string"},"record_date_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].record_date_at","typeLabel":"string\u003cdate-time>"},"business_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].business_date","typeLabel":"string"},"status":{"type":"string","examples":["pending","running","completed","failed","timeout","cancelled","skipped"],"description":"[Extensible enum] Known values: \"pending\", \"running\", \"completed\", \"failed\", \"timeout\", \"cancelled\", \"skipped\"; more may be added.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].status","typeLabel":"string"},"position":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].position.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].position","typeLabel":"integer | null"},"mention_rank":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].mention_rank.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].mention_rank.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].mention_rank","typeLabel":"integer | null"},"mentions":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].mentions.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].mentions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].mentions","typeLabel":"integer | null"},"sentiment":{"oneOf":[{"type":"string","examples":["positive","neutral","negative","mixed"],"description":"[Extensible enum] Known values: \"positive\", \"neutral\", \"negative\", \"mixed\"; more may be added.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].sentiment.oneOf.0","typeLabel":"string"},{"type":"null","examples":["positive","neutral","negative","mixed"],"description":"[Extensible enum] Known values: \"positive\", \"neutral\", \"negative\", \"mixed\"; more may be added.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].sentiment.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].sentiment","typeLabel":"string | null"},"sentiment_polarity":{"oneOf":[{"type":"number","minimum":-1,"maximum":1,"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].sentiment_polarity.oneOf.0","typeLabel":"number"},{"type":"null","minimum":-1,"maximum":1,"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].sentiment_polarity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].sentiment_polarity","typeLabel":"number | null"},"shopping_visible":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].shopping_visible.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].shopping_visible.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].shopping_visible","typeLabel":"boolean | null"}},"required":["id","platform_code","platform_name","record_date_at","business_date","status","position","mention_rank","mentions","sentiment","sentiment_polarity","shopping_visible"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.oneOf.0.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Monitoring records of one prompt. null only when meta.schema_conformant is false and the output could not be mapped.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Monitoring records of one prompt. null only when meta.schema_conformant is false and the output could not be mapped.","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"object[] | null"},"page":{"type":"object","description":"Cursor pagination. next_cursor === null is the only end-of-list signal.","properties":{"next_cursor":{"oneOf":[{"type":"string","description":"Pass as `cursor` with the same filters and limit to get the next page.","isRequired":true,"uniqueKey":"page.next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"Pass as `cursor` with the same filters and limit to get the next page.","isRequired":true,"uniqueKey":"page.next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"page.next_cursor","typeLabel":"string | null"},"limit":{"type":"integer","isRequired":true,"uniqueKey":"page.limit","typeLabel":"integer"},"total":{"oneOf":[{"type":"integer","description":"Total rows matching the filters.","isRequired":true,"uniqueKey":"page.total.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Total rows matching the filters.","isRequired":true,"uniqueKey":"page.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"page.total","typeLabel":"integer | null"},"capped":{"type":"boolean","const":true,"description":"Present when the position limit was reached before the end of the list.","uniqueKey":"page.capped","typeLabel":"boolean"}},"required":["next_cursor","limit","total"],"isRequired":true,"uniqueKey":"page","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","description":"Report name for POST /api/v1/reports/{report}; resource labels include quota, brand, topics, prompt-catalog, prompt, prompt-records, prompt-records-latest, record, record-feed, created-prompt and prompt-run.","isRequired":true,"uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","isRequired":true,"uniqueKey":"meta.duration_ms","typeLabel":"integer"},"schema_conformant":{"type":"boolean","description":"true = data matches the documented schema exactly (every declared key present). false = the report output drifted; data is still returned as mapped (or null) — treat it as best effort.","isRequired":true,"uniqueKey":"meta.schema_conformant","typeLabel":"boolean"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id","report","duration_ms","schema_conformant"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["data","page","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"\u003cstring>","platform_code":"\u003cstring>","platform_name":"\u003cstring>","record_date_at":"2023-11-07T05:31:56Z","business_date":"\u003cstring>","status":"pending","position":123,"mention_rank":123,"mentions":1,"sentiment":"positive","sentiment_polarity":0,"shopping_visible":true}],"page":{"next_cursor":"\u003cstring>","limit":123,"total":123,"capped":true},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"schema_conformant":true,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"299a88c3-cd32-4f9c-84ff-f1389cf20684":{"description":"INVALID_ARGUMENT (unknown query parameter, non-integer or out-of-range number, invalid enum value — details.errors[] lists each {param, reason, allowed?}) / INVALID_CURSOR (the cursor is malformed or belongs to another query — other filters or limit; drop it and start over) / FAILED_PRECONDITION (for example platform_not_enabled). Schema-level rejections are not charged; tool-level rejections retain their billing outcome in meta.quota.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"8d6da85e-4819-410c-b472-d24fa65047b3":{"description":"UNAUTHORIZED: missing or invalid API key.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"f930b272-726d-49d3-9d1b-8cb4d791adce":{"description":"QUOTA_EXCEEDED / SUBSCRIPTION_INACTIVE / ORG_NOT_ELIGIBLE. Not charged.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"c7a03b9a-f958-433d-b084-ae721da636b0":{"description":"API_KEY_BRAND_REQUIRED (the key is not bound to a brand) / PERMISSION_DENIED (the key lacks the read permission in x-geoly-required-permission; details.required names it). Not charged.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"2f6bbcef-3873-4cb3-a35c-b7dd6b082435":{"description":"NOT_FOUND: no prompt with this prompt_id for the brand of this API key (details.reason = \"not_found\", details.resource = \"prompt\", details.id echoes the prompt_id). Billing follows meta.quota.charge.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"dacbfb70-eda4-44ca-94fe-cbd8f5ed2bfc":{"description":"RATE_LIMITED / GUARDED_RATE_LIMITED / BUSY / BUDGET_EXCEEDED. Not charged; honor Retry-After and pace with X-DB-Budget-*.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying (429; 503 when retryable).","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"96e7c137-07e9-4c88-969e-29748f3c39b2":{"description":"INTERNAL_ERROR: unexpected server error (not charged). Retry once with backoff; report the Request-Id if it persists.","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"2f760f9c-752c-4ee2-b0e0-123e3f68f8d9":{"description":"TOOL_TIMEOUT / OVERLOADED / CIRCUIT_OPEN / TOOL_FAILED. Not charged; retry later, honoring Retry-After when present. (502 / 504 are never used.)","headers":{"Request-Id":{"description":"Unique id of this request (equals meta.request_id). Include it when reporting a problem.","schema":{"type":"string"}},"GEOly-API-Version":{"description":"API contract version. Always \"1\" on /api/v1.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Requests allowed per credential in the current one-minute window. Sent on every response after the API key has been authenticated; absent on errors raised while authenticating (401) and on 405.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets (0–60).","schema":{"type":"integer"}},"X-DB-Budget-Limit":{"description":"Organization database-seconds budget per rolling 60 minutes. Sent on every response after authentication.","schema":{"type":"integer"}},"X-DB-Budget-Used":{"description":"Database seconds used by the organization in the last 60 minutes.","schema":{"type":"integer"}},"X-DB-Budget-Reset":{"description":"Seconds until the oldest usage bucket expires.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying (429; 503 when retryable).","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"[Extensible enum] One of x-geoly-error-codes.","examples":["INVALID_BODY","INVALID_ARGUMENT","INVALID_CURSOR","IDEMPOTENCY_KEY_INVALID","FAILED_PRECONDITION","UNAUTHORIZED","SUBSCRIPTION_INACTIVE","QUOTA_EXCEEDED","ORG_NOT_ELIGIBLE","PLAN_LIMIT_REACHED","API_KEY_BRAND_REQUIRED","ORG_SELECTION_REQUIRED","ORGANIZATION_REQUIRED","PERMISSION_DENIED","REPORT_NOT_FOUND","NOT_FOUND","METHOD_NOT_ALLOWED","IDEMPOTENCY_KEY_REUSED","REQUEST_IN_PROGRESS","IDEMPOTENCY_OUTCOME_UNKNOWN","TOOL_SURFACE_RETIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","QUERY_TOO_EXPENSIVE","RESPONSE_TOO_LARGE","RATE_LIMITED","GUARDED_RATE_LIMITED","BUSY","BUDGET_EXCEEDED","INTERNAL_ERROR","TOOL_TIMEOUT","OVERLOADED","CIRCUIT_OPEN","TOOL_FAILED","FEED_NOT_READY","IDEMPOTENCY_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans; do not parse.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Stable keys: errors[] ({param, reason, allowed?, message}) on INVALID_ARGUMENT; reason; required (PERMISSION_DENIED); retry_after_seconds (429); max_bytes / actual_bytes (413 / 422); _quota (receipt); resource / id (404 NOT_FOUND of a single-resource endpoint). Other keys are informational and may change.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"report":{"type":"string","uniqueKey":"meta.report","typeLabel":"string"},"duration_ms":{"type":"integer","uniqueKey":"meta.duration_ms","typeLabel":"integer"},"quota":{"type":"object","description":"Billing outcome of this call. remaining / resets_at / unlimited are null on paths that never reserved credits (free reports, calls rejected before execution) — except QUOTA_EXCEEDED, which carries the live balance. Absent when the call was rejected before the report ran (schema errors, cursor errors, authentication).","properties":{"cost":{"type":"integer","description":"Credits actually charged for this call.","isRequired":true,"uniqueKey":"meta.quota.cost","typeLabel":"integer"},"unlimited":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"meta.quota.unlimited.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.unlimited","typeLabel":"boolean | null"},"remaining":{"oneOf":[{"type":"integer","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits left this period; null when unlimited or unknown on this path.","isRequired":true,"uniqueKey":"meta.quota.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.remaining","typeLabel":"integer | null"},"resets_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"meta.quota.resets_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.resets_at","typeLabel":"string\u003cdate-time> | null"},"charge":{"type":"string","examples":["charged","min_fee","free","refunded","refund_pending","unbilled"],"description":"[Extensible enum] charged = normal settlement (per row, or one call for a call-priced read — including a not-found from the prompt or record detail); min_fee = minimum call fee (no data / not found from a per-row report / platform not purchased / missing locale); free = free report or endpoint; refunded / refund_pending = failed and refunded; unbilled = rejected before execution, or not metered.","isRequired":true,"uniqueKey":"meta.quota.charge","typeLabel":"string"},"min_fee_reason":{"oneOf":[{"type":"string","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.0","typeLabel":"string"},{"type":"null","examples":["missing_locale","no_data",null],"description":"[Extensible enum]","isRequired":true,"uniqueKey":"meta.quota.min_fee_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.quota.min_fee_reason","typeLabel":"string | null"}},"required":["cost","unlimited","remaining","resets_at","charge","min_fee_reason"],"uniqueKey":"meta.quota","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_BODY","message":"\u003cstring>","details":{}},"meta":{"request_id":"\u003cstring>","report":"\u003cstring>","duration_ms":123,"quota":{"cost":123,"unlimited":true,"remaining":123,"resets_at":"2023-11-07T05:31:56Z","charge":"charged","min_fee_reason":"missing_locale"}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"62255991-e1ad-4b3b-bf92-71e13392d4f3":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key from Settings → Developer → API keys (prefix geom_). Each key is bound to one brand.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"ff9899c6-8f8e-4cb4-84f4-02cccd12d5a4":{"url":"https://app.geoly.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key from Settings → Developer → API keys (prefix geom_). Each key is bound to one brand.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key from Settings → Developer → API keys (prefix geom_). Each key is bound to one brand.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"ge-oly","siteName":"GEOly Docs","title":"List prompt records - GEOly Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/records/list-prompt-records","matchLevel":0},"zh":{"href":"/zh/api-reference/records/list-prompt-records","matchLevel":1}}},"lastModified":"2026-11-02T10:40:30.503Z","originalFileLocation":"api-reference/records/list-prompt-records.mdx","locale":"en"},"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=\"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.\">\u003cmeta data-mint-head name=\"application-name\" content=\"GEOly 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/ge-oly/PxJaGKKHma1N8v8R/_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/ge-oly/PxJaGKKHma1N8v8R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ge-oly/PxJaGKKHma1N8v8R/_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/ge-oly/PxJaGKKHma1N8v8R/_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/ge-oly/PxJaGKKHma1N8v8R/_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/ge-oly/PxJaGKKHma1N8v8R/_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/ge-oly/PxJaGKKHma1N8v8R/_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/ge-oly/PxJaGKKHma1N8v8R/_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/ge-oly/PxJaGKKHma1N8v8R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List prompt records - GEOly Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GEOly Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.geoly.ai/api-reference/records/list-prompt-records\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ge-oly.mintlify.app/_mintlify/api/og/v2?division=Records\u0026amp;title=List+prompt+records\u0026amp;description=Paginated+records%2C+including+pending+and+failed+runs.+At+most+10%2C000+positions+per+query+are+reachable+%28page.capped%29%3B+narrow+the+date+window+to+continue.+Cursor\u0026amp;theme=6f479ed031130532e88a7020\u0026amp;signature=fba9f4df665f005a791d00a69d30608d6bd7acd4981e26b1de39d4b4943519b5\">\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=\"List prompt records - GEOly Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ge-oly.mintlify.app/_mintlify/api/og/v2?division=Records\u0026amp;title=List+prompt+records\u0026amp;description=Paginated+records%2C+including+pending+and+failed+runs.+At+most+10%2C000+positions+per+query+are+reachable+%28page.capped%29%3B+narrow+the+date+window+to+continue.+Cursor\u0026amp;theme=6f479ed031130532e88a7020\u0026amp;signature=fba9f4df665f005a791d00a69d30608d6bd7acd4981e26b1de39d4b4943519b5\">\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/ge-oly/PxJaGKKHma1N8v8R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GEOly Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0A0A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.geoly.ai/api-reference/records/list-prompt-records\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/records/list-prompt-records.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.geoly.ai/api-reference/records/list-prompt-records\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.geoly.ai/zh/api-reference/records/list-prompt-records\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.geoly.ai/api-reference/records/list-prompt-records\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.geoly.ai/#organization\",\"name\":\"GEOly Docs\",\"url\":\"https://docs.geoly.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ge-oly/Cn9GPNuGnA715ktI/logo/light.svg?fit=max\u0026auto=format\u0026n=Cn9GPNuGnA715ktI\u0026q=85\u0026s=d3cea28520cc9660b9bd70ab642920fe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.geoly.ai#website\",\"name\":\"GEOly Docs\",\"url\":\"https://docs.geoly.ai\",\"publisher\":{\"@id\":\"https://docs.geoly.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records#webpage\",\"url\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records\",\"name\":\"List prompt records\",\"description\":\"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.\",\"dateModified\":\"2026-11-02T10:40:30.503Z\",\"isPartOf\":{\"@id\":\"https://docs.geoly.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"GEOly Docs\",\"item\":\"https://docs.geoly.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List prompt records\",\"item\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records#apireference\",\"headline\":\"List prompt records\",\"name\":\"List prompt records\",\"description\":\"Paginated records, including pending and failed runs. At most 10,000 positions per query are reachable (page.capped); narrow the date window to continue. Cursors bind the brand, prompt, filters and limit. Pagination is not a snapshot: concurrent changes may skip or repeat records. Use explicit dates and deduplicate by id. Windows over 90 days use the long-window multiplier in x-geoly-cost. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.\",\"url\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records\",\"mainEntityOfPage\":{\"@id\":\"https://docs.geoly.ai/api-reference/records/list-prompt-records#webpage\"},\"dateModified\":\"2026-11-02T10:40:30.503Z\",\"publisher\":{\"@id\":\"https://docs.geoly.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.geoly.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GEOly Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"GEOly Docs","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"MCP Server","icon":"plug","pages":[{"title":"MCP Server","href":"/developers/mcp"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Get started","icon":"book-open","pages":[{"title":"GEOly Data API","sidebarTitle":"Overview","href":"/developers/data-api"}]},{"group":"Account","icon":"user","pages":[{"title":"Get brand","openapi":"api-reference/openapi.json GET /api/v1/brand","href":"/api-reference/account/get-brand"},{"title":"Get quota","openapi":"api-reference/openapi.json GET /api/v1/quota","href":"/api-reference/account/get-quota"}]},{"group":"Catalog","icon":"list","pages":[{"title":"List topics","openapi":"api-reference/openapi.json GET /api/v1/topics","href":"/api-reference/catalog/list-topics"},{"title":"List prompts","openapi":"api-reference/openapi.json GET /api/v1/prompts","href":"/api-reference/catalog/list-prompts"},{"title":"Get prompt","openapi":"api-reference/openapi.json GET /api/v1/prompts/{prompt_id}","href":"/api-reference/catalog/get-prompt"},{"title":"Create prompt","openapi":"api-reference/openapi.json POST /api/v1/prompts","description":"Creates a prompt under the API key brand. Returns 201 and Location. Optional Idempotency-Key prevents duplicate execution; successful results replay for 24 hours. Unknown write outcomes are never automatically retried. tags_state reports whether every requested tag was read back (saved), some were not saved (partial) or the saved tags could not be confirmed (unavailable); tags_warning explains anything but saved. The prompt exists in all three cases.","href":"/api-reference/catalog/create-prompt"}]},{"group":"Records","icon":"database","pages":[{"title":"List prompt records","openapi":"api-reference/openapi.json GET /api/v1/prompts/{prompt_id}/records","href":"/api-reference/records/list-prompt-records"},{"title":"Get latest records","openapi":"api-reference/openapi.json GET /api/v1/prompts/{prompt_id}/records/latest","description":"One latest record per platform, without a date filter. A valid prompt with no records returns an empty array. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.","href":"/api-reference/records/get-latest-records"},{"title":"Get record","openapi":"api-reference/openapi.json GET /api/v1/records/{record_id}","href":"/api-reference/records/get-record"},{"title":"Sync records","openapi":"api-reference/openapi.json GET /api/v1/records","href":"/api-reference/records/sync-records"},{"title":"Trigger run","openapi":"api-reference/openapi.json POST /api/v1/prompts/{prompt_id}/runs","href":"/api-reference/records/trigger-run"}]},{"group":"Reports","icon":"chart-column","pages":[{"title":"Overview report","openapi":"api-reference/openapi.json POST /api/v1/reports/overview","href":"/api-reference/reports/overview"},{"title":"Analytics report","openapi":"api-reference/openapi.json POST /api/v1/reports/analytics","href":"/api-reference/reports/analytics"},{"title":"Brand board","openapi":"api-reference/openapi.json POST /api/v1/reports/brand-board","href":"/api-reference/reports/brand-board"},{"title":"Citations report","openapi":"api-reference/openapi.json POST /api/v1/reports/citations","href":"/api-reference/reports/citations"},{"title":"Prompts report","openapi":"api-reference/openapi.json POST /api/v1/reports/prompts","href":"/api-reference/reports/prompts"},{"title":"Prompt overview","openapi":"api-reference/openapi.json POST /api/v1/reports/prompt-overview","href":"/api-reference/reports/prompt-overview"}]}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/records/list-prompt-records"}]}]},"basePath":"","title":"List prompt records - GEOly 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"]}