{ "items": [ { "id": "97ac0c55-7349-46ec-8670-92f8524f5294", "documentCategory": "interim-financial-report", "title": "Third Quarter Report", "description": "Santos Limited third quarter report for the period ending 30 September 2026, summarising record quarterly production and free cash flow, operational performance across assets (including Barossa, Pikka and PNG LNG), sales and pricing, updated 2026 guidance and project developments.", "date": "2026-10-22", "fiscalQuarter": 3, "fiscalYear": 2026, "fiscalPeriod": "quarter", "language": "en", "companyId": "77848abe-a215-41b7-8950-86e89ea1fadc", "companyName": "Santos Ltd.", "companyTickers": [ "STO.AX" ], "metadata": {} } ], "nextPageToken": "MTMxNS4wMDBhNmU1Yy0xYjJkLTRlNGYtOGE5Yy0zZDJlMWYwYTliN2M", "cursor": 1315}
Changes
Changes Snapshot
Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with GET /api/v2/changes.
Page through it with pageToken (each response’s nextPageToken, until it is null), then follow the feed from cursor. Load companies first, then documents, and follow the feed from the cursor of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes.
Unlike /documents/list, paging can’t skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from GET /api/v2/documents/{id}.
GET
/
api
/
v2
/
changes
/
snapshot
Snapshot for the changes feed
curl --request GET \ --url https://rest-api.captide.co/api/v2/changes/snapshot \ --header 'X-API-Key: <api-key>'
The feed position this snapshot started at, the same on every page: call GET /api/v2/changes with it as after once the snapshot is loaded
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Captide API","colors":{"primary":"#478ef8","light":"#478ef8","dark":"#478ef8"},"logo":{"light":"https://mintcdn.com/captide/9nTwxd7pkhCHGj3r/logo/light.svg?fit=max\u0026auto=format\u0026n=9nTwxd7pkhCHGj3r\u0026q=85\u0026s=f6615b1fe22f08cba979a10550c982df","dark":"https://mintcdn.com/captide/9nTwxd7pkhCHGj3r/logo/dark.svg?fit=max\u0026auto=format\u0026n=9nTwxd7pkhCHGj3r\u0026q=85\u0026s=1b6ed8e12928c3d8d768f7c25647cdd6"},"favicon":"https://mintcdn.com/captide/9nTwxd7pkhCHGj3r/favicon.svg?fit=max\u0026auto=format\u0026n=9nTwxd7pkhCHGj3r\u0026q=85\u0026s=98836a1114e87469711b68f291635b09","api":{"openapi":"https://rest-api.captide.co/openapi.json","playground":{"display":"interactive"}},"navbar":{"links":[{"href":"mailto:support@captide.co","label":"Support"}]},"footer":{"socials":{"github":"https://github.com/captide-tech","linkedin":"https://linkedin.com/company/captide"}},"integrations":{"ga4":{"measurementId":"G-S25SS09G77"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"captide","hasAudioNarration":false,"actualSubdomain":"captide","customDomains":["docs.captide.ai"],"gitSource":{"type":"github","owner":"captide-tech","repo":"captide-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb92b52b386302aeb28adc","collectionId":"17078421-2f96-494e-b011-f99a636e8e7e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb92b52b386302aeb28adc"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aeb941e97823f91bdd364d6","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Webhooks","count":5},{"language":"default","tag":"Integration","count":5},{"language":"default","tag":"Agentic RAG","count":4},{"language":"default","tag":"Companies","count":3},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Changes","count":2},{"language":"default","tag":"Documents","count":2},{"language":"default","tag":"API documentation","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/changes_snapshot","slug":"/api-reference/endpoint/changes_snapshot","pageMetadata":{"title":"Changes Snapshot","openapi":"GET /api/v2/changes/snapshot","description":"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with `GET /api/v2/changes`.\n\n Page through it with `pageToken` (each response's `nextPageToken`, until it is null), then follow the feed from `cursor`. Load companies first, then documents, and follow the feed from the `cursor` of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes.\n\n Unlike `/documents/list`, paging can't skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from `GET /api/v2/documents/{id}`.","href":"/api-reference/endpoint/changes_snapshot"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with \", _jsx(_components.code, {\n children: \"GET /api/v2/changes\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Page through it with \", _jsx(_components.code, {\n children: \"pageToken\"\n }), \" (each response’s \", _jsx(_components.code, {\n children: \"nextPageToken\"\n }), \", until it is null), then follow the feed from \", _jsx(_components.code, {\n children: \"cursor\"\n }), \". Load companies first, then documents, and follow the feed from the \", _jsx(_components.code, {\n children: \"cursor\"\n }), \" of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Unlike \", _jsx(_components.code, {\n children: \"/documents/list\"\n }), \", paging can’t skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from \", _jsx(_components.code, {\n children: \"GET /api/v2/documents/{id}\"\n }), \".\"]\n })]\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":"Changes Snapshot","openapi":"GET /api/v2/changes/snapshot","description":"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with `GET /api/v2/changes`.\n\n Page through it with `pageToken` (each response's `nextPageToken`, until it is null), then follow the feed from `cursor`. Load companies first, then documents, and follow the feed from the `cursor` of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes.\n\n Unlike `/documents/list`, paging can't skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from `GET /api/v2/documents/{id}`.","href":"/api-reference/endpoint/changes_snapshot"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Changes"],"summary":"Snapshot for the changes feed","description":"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with `GET /api/v2/changes`.\n\n Page through it with `pageToken` (each response's `nextPageToken`, until it is null), then follow the feed from `cursor`. Load companies first, then documents, and follow the feed from the `cursor` of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes.\n\n Unlike `/documents/list`, paging can't skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from `GET /api/v2/documents/{id}`.","operationId":"changes_snapshot_api_v2_changes_snapshot_get","security":["6ed9e22d-9055-47d9-a209-5fe6c0b39856"],"parameters":["23a3e146-5f91-47e6-963d-d124c3f5c288","8e615d71-7668-4064-a2da-a2959dedcf30","9cdef0fb-10f9-4660-bead-2d6ccefa5644","f06349b3-7f42-467d-bccf-43a05fa052bb"],"responses":{"200":"b7f8b8b9-e6cc-455b-89d3-cb0280fff1cb","400":"e08b1a11-1c81-4d7d-b009-2fe2cb34d97a","401":"a8302d0d-2a48-4732-af5e-132e62b2fb86","403":"2396eafe-2c4b-4a27-8ea9-b5b4502cf2c3","422":"198b645a-a732-4922-bf5f-8af565cab348","429":"c4e64a4b-0fc9-4fa9-8977-bfd349142dc8","500":"fd1eef52-7d0b-4733-b671-750072841a3c"},"method":"get","type":"path","servers":["b86aea2b-e867-4413-ac00-32dcb467d264"],"path":"/api/v2/changes/snapshot","baseUrlOptions":["https://rest-api.captide.co"],"title":"Snapshot for the changes feed","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"23a3e146-5f91-47e6-963d-d124c3f5c288":{"name":"type","in":"query","required":true,"schema":{"enum":["document","company"],"type":"string","description":"`document` or `company`","examples":["document"],"title":"Type","isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"`document` or `company`"},"8e615d71-7668-4064-a2da-a2959dedcf30":{"name":"pageToken","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Pagetoken","description":"`nextPageToken` from the previous page; omit for the first page","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Pagetoken","description":"`nextPageToken` from the previous page; omit for the first page","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"`nextPageToken` from the previous page; omit for the first page"},"9cdef0fb-10f9-4660-bead-2d6ccefa5644":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum number of items to return","examples":[100],"default":100,"title":"Limit","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Maximum number of items to return"},"f06349b3-7f42-467d-bccf-43a05fa052bb":{"name":"companyIds","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Companyids","description":"Comma-separated company IDs: only these companies, or only their documents","example":"77848abe-a215-41b7-8950-86e89ea1fadc","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Companyids","description":"Comma-separated company IDs: only these companies, or only their documents","example":"77848abe-a215-41b7-8950-86e89ea1fadc","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Comma-separated company IDs: only these companies, or only their documents"}},"responses":{"b7f8b8b9-e6cc-455b-89d3-cb0280fff1cb":{"description":"A page of documents","content":{"application/json":{"schema":{"properties":{"items":{"items":{"oneOf":[{"type":"object","title":"ChangedDocument","description":"A document as the API shows it, without file links (they expire; fetch them from `GET /api/v2/documents/{id}`).","required":["id","documentCategory","companyId"],"properties":{"id":{"type":"string","title":"Id","description":"Document ID, as used by `GET /api/v2/documents/{id}`. A new version of the document's file has a new ID; the old one is in `previous.id`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.0.id","typeLabel":"string"},"documentCategory":{"type":"string","title":"Documentcategory","description":"Document category code. See [Coverage](/coverage).","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.0.documentCategory","typeLabel":"string"},"companyId":{"type":"string","title":"Companyid","description":"ID of the company the document belongs to","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.0.companyId","typeLabel":"string"},"secFormType":{"oneOf":[{"type":"string","title":"Secformtype","description":"SEC form type, for SEC filings","uniqueKey":"\\items.items.[INDEX].oneOf.0.secFormType.oneOf.0","typeLabel":"string"},{"type":"null","title":"Secformtype","description":"SEC form type, for SEC filings","uniqueKey":"\\items.items.[INDEX].oneOf.0.secFormType.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.secFormType","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Captide-generated document title","uniqueKey":"\\items.items.[INDEX].oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Captide-generated document title","uniqueKey":"\\items.items.[INDEX].oneOf.0.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.title","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","description":"Captide-generated document description","uniqueKey":"\\items.items.[INDEX].oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"Captide-generated document description","uniqueKey":"\\items.items.[INDEX].oneOf.0.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.description","typeLabel":"string | null"},"date":{"oneOf":[{"type":"string","title":"Date","description":"Date of the document, as in `/documents/list`","uniqueKey":"\\items.items.[INDEX].oneOf.0.date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Date","description":"Date of the document, as in `/documents/list`","uniqueKey":"\\items.items.[INDEX].oneOf.0.date.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.date","typeLabel":"string | null"},"fiscalQuarter":{"oneOf":[{"type":"integer","title":"Fiscalquarter","description":"Fiscal quarter (1 to 4)","uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalQuarter.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Fiscalquarter","description":"Fiscal quarter (1 to 4)","uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalQuarter.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalQuarter","typeLabel":"integer | null"},"fiscalYear":{"oneOf":[{"type":"integer","title":"Fiscalyear","description":"Fiscal year","uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalYear.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Fiscalyear","description":"Fiscal year","uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalYear","typeLabel":"integer | null"},"fiscalPeriod":{"oneOf":[{"type":"string","title":"Fiscalperiod","description":"`year`, `multi-year`, `month`, `half-year`, `quarter` or null","uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalPeriod.oneOf.0","typeLabel":"string"},{"type":"null","title":"Fiscalperiod","description":"`year`, `multi-year`, `month`, `half-year`, `quarter` or null","uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalPeriod.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.fiscalPeriod","typeLabel":"string | null"},"language":{"oneOf":[{"type":"string","title":"Language","description":"ISO 639-1 language code","uniqueKey":"\\items.items.[INDEX].oneOf.0.language.oneOf.0","typeLabel":"string"},{"type":"null","title":"Language","description":"ISO 639-1 language code","uniqueKey":"\\items.items.[INDEX].oneOf.0.language.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.language","typeLabel":"string | null"},"companyName":{"oneOf":[{"type":"string","title":"Companyname","description":"The company's name now","uniqueKey":"\\items.items.[INDEX].oneOf.0.companyName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Companyname","description":"The company's name now","uniqueKey":"\\items.items.[INDEX].oneOf.0.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.0.companyName","typeLabel":"string | null"},"companyTickers":{"items":{"type":"string","uniqueKey":"\\items.items.[INDEX].oneOf.0.companyTickers.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Companytickers","description":"The company's tickers now","uniqueKey":"\\items.items.[INDEX].oneOf.0.companyTickers","typeLabel":"string[]"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"As in `GET /api/v2/documents/{id}`","uniqueKey":"\\items.items.[INDEX].oneOf.0.metadata","typeLabel":"Metadata · object"}},"uniqueKey":"\\items.items.[INDEX].oneOf.0","typeLabel":"ChangedDocument · object"},{"type":"object","title":"CompanyResponse","description":"Response model for single company retrieval.","required":["id","name","tickers","countries","filesWithSec"],"properties":{"id":{"type":"string","title":"Id","description":"Unique company ID","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"Company name","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.name","typeLabel":"string"},"tickers":{"items":{"type":"string","uniqueKey":"\\items.items.[INDEX].oneOf.1.tickers.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Tickers","description":"List of ticker symbols with exchange suffixes (e.g., 'ASML', 'ASML.AS')","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.tickers","typeLabel":"string[]"},"countries":{"items":{"type":"string","uniqueKey":"\\items.items.[INDEX].oneOf.1.countries.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Countries","description":"Company's country of domicile (ISO 3166-1 alpha-2)","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.countries","typeLabel":"string[]"},"filesWithSec":{"type":"boolean","title":"Fileswithsec","description":"Whether the company files reports with the SEC","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.filesWithSec","typeLabel":"boolean"},"cik":{"oneOf":[{"type":"string","title":"Cik","description":"Central Index Key (CIK) assigned by the SEC","uniqueKey":"\\items.items.[INDEX].oneOf.1.cik.oneOf.0","typeLabel":"string"},{"type":"null","title":"Cik","description":"Central Index Key (CIK) assigned by the SEC","uniqueKey":"\\items.items.[INDEX].oneOf.1.cik.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.1.cik","typeLabel":"string | null"},"permId":{"oneOf":[{"type":"string","title":"Permid","description":"PermID (Permanent Identifier) assigned by Refinitiv","uniqueKey":"\\items.items.[INDEX].oneOf.1.permId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Permid","description":"PermID (Permanent Identifier) assigned by Refinitiv","uniqueKey":"\\items.items.[INDEX].oneOf.1.permId.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].oneOf.1.permId","typeLabel":"string | null"}},"uniqueKey":"\\items.items.[INDEX].oneOf.1","typeLabel":"CompanyResponse · object"}],"uniqueKey":"\\items.items.[INDEX]","typeLabel":"ChangedDocument · object | CompanyResponse · object"},"type":"array","title":"Items","description":"Documents or companies, as the changes feed shows them","isRequired":true,"uniqueKey":"\\items","typeLabel":"(ChangedDocument · object | CompanyResponse · object)[]"},"nextPageToken":{"oneOf":[{"type":"string","title":"Nextpagetoken","description":"Pass as `pageToken` for the next page; null on the last page","isRequired":true,"uniqueKey":"nextPageToken.oneOf.0","typeLabel":"string"},{"type":"null","title":"Nextpagetoken","description":"Pass as `pageToken` for the next page; null on the last page","isRequired":true,"uniqueKey":"nextPageToken.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nextPageToken","typeLabel":"string | null"},"cursor":{"type":"integer","title":"Cursor","description":"The feed position this snapshot started at, the same on every page: call `GET /api/v2/changes` with it as `after` once the snapshot is loaded","isRequired":true,"uniqueKey":"cursor","typeLabel":"integer"}},"type":"object","required":["items","nextPageToken","cursor"],"title":"ChangesSnapshotResponse","description":"A page of the snapshot.","uniqueKey":"","typeLabel":"ChangesSnapshotResponse · object"},"example":{"items":[{"id":"97ac0c55-7349-46ec-8670-92f8524f5294","documentCategory":"interim-financial-report","title":"Third Quarter Report","description":"Santos Limited third quarter report for the period ending 30 September 2026, summarising record quarterly production and free cash flow, operational performance across assets (including Barossa, Pikka and PNG LNG), sales and pricing, updated 2026 guidance and project developments.","date":"2026-10-22","fiscalQuarter":3,"fiscalYear":2026,"fiscalPeriod":"quarter","language":"en","companyId":"77848abe-a215-41b7-8950-86e89ea1fadc","companyName":"Santos Ltd.","companyTickers":["STO.AX"],"metadata":{}}],"nextPageToken":"MTMxNS4wMDBhNmU1Yy0xYjJkLTRlNGYtOGE5Yy0zZDJlMWYwYTliN2M","cursor":1315},"examples":{"Example":{"title":"Example","value":{"items":[{"id":"97ac0c55-7349-46ec-8670-92f8524f5294","documentCategory":"interim-financial-report","title":"Third Quarter Report","description":"Santos Limited third quarter report for the period ending 30 September 2026, summarising record quarterly production and free cash flow, operational performance across assets (including Barossa, Pikka and PNG LNG), sales and pricing, updated 2026 guidance and project developments.","date":"2026-10-22","fiscalQuarter":3,"fiscalYear":2026,"fiscalPeriod":"quarter","language":"en","companyId":"77848abe-a215-41b7-8950-86e89ea1fadc","companyName":"Santos Ltd.","companyTickers":["STO.AX"],"metadata":{}}],"nextPageToken":"MTMxNS4wMDBhNmU1Yy0xYjJkLTRlNGYtOGE5Yy0zZDJlMWYwYTliN2M","cursor":1315}}},"exampleType":"examples"}},"exampleType":"examples"},"e08b1a11-1c81-4d7d-b009-2fe2cb34d97a":{"description":"Invalid request parameters","content":{"application/json":{"examples":{"invalid_page_token":{"title":"invalid_page_token","value":{"detail":"Invalid pageToken"}},"invalid_company_id":{"title":"invalid_company_id","value":{"detail":"Invalid companyIds: each value must be a UUID"}}},"schema":{"properties":{"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Standard error response model for all API endpoints.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"exampleType":"examples"},"a8302d0d-2a48-4732-af5e-132e62b2fb86":{"description":"Missing or invalid API key","content":{"application/json":{"examples":{"missing_key":{"title":"missing_key","value":{"detail":"Missing API key"}},"invalid_key":{"title":"invalid_key","value":{"detail":"Invalid or expired API key"}}},"schema":{"properties":{"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Standard error response model for all API endpoints.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"exampleType":"examples"},"2396eafe-2c4b-4a27-8ea9-b5b4502cf2c3":{"description":"Your organization doesn't have access to this endpoint","content":{"application/json":{"examples":{"forbidden":{"title":"forbidden","value":{"detail":"Access to this endpoint is not allowed for your organization"}}},"schema":{"properties":{"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Standard error response model for all API endpoints.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"exampleType":"examples"},"198b645a-a732-4922-bf5f-8af565cab348":{"description":"Validation error: a parameter or body field is missing, has the wrong type or is out of range","content":{"application/json":{"example":{"detail":[{"type":"less_than_equal","loc":["query","limit"],"msg":"Input should be less than or equal to 1000","input":"5000","ctx":{"le":1000}}]},"schema":{"properties":{"detail":{"items":{"properties":{"type":{"type":"string","title":"Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"},{"type":"null","title":"Input","uniqueKey":"detail.items.[INDEX].input.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"null"},"ctx":{"oneOf":[{"type":"object","title":"Ctx","additionalProperties":true,"uniqueKey":"detail.items.[INDEX].ctx.oneOf.0","typeLabel":"Ctx · object"},{"type":"null","title":"Ctx","uniqueKey":"detail.items.[INDEX].ctx.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Ctx · object | null"}},"type":"object","required":["type","loc","msg"],"title":"ValidationErrorItem","description":"One invalid field, as FastAPI reports it.","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationErrorItem · object"},"type":"array","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"ValidationErrorItem · object[]"}},"type":"object","required":["detail"],"title":"ValidationErrorResponse","description":"422 body: every invalid field of the request.","uniqueKey":"","typeLabel":"ValidationErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"type":"less_than_equal","loc":["query","limit"],"msg":"Input should be less than or equal to 1000","input":"5000","ctx":{"le":1000}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"c4e64a4b-0fc9-4fa9-8977-bfd349142dc8":{"description":"Rate limit exceeded","content":{"application/json":{"examples":{"rate_limited":{"title":"rate_limited","value":{"detail":"Rate limit exceeded: 100 requests per minute"}}},"schema":{"properties":{"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Standard error response model for all API endpoints.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"exampleType":"examples"},"fd1eef52-7d0b-4733-b671-750072841a3c":{"description":"Internal server error","content":{"application/json":{"examples":{"database_error":{"title":"database_error","value":{"detail":"Database error occurred"}}},"schema":{"properties":{"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Standard error response model for all API endpoints.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6ed9e22d-9055-47d9-a209-5fe6c0b39856":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"b86aea2b-e867-4413-ac00-32dcb467d264":{"url":"https://rest-api.captide.co","description":"Prod server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"}]},"originalFileLocation":"https://rest-api.captide.co/openapi.json"},"subdomain":"captide","siteName":"Captide API","title":"Changes Snapshot - Captide API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T20:17:46.711Z","originalFileLocation":"api-reference/endpoint/changes_snapshot.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with GET /api/v2/changes. Page through it with pageToken (each response\u0026#x27;s nextPageToken, until it is null), then follow the feed from cursor. Load companies first, then documents, and follow the feed from the cursor of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes. Unlike /documents/list, paging can\u0026#x27;t skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from GET /api/v2/documents/{id}.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Captide API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/captide/-FVRvyiygpJBqmBK/_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/captide/-FVRvyiygpJBqmBK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/captide/-FVRvyiygpJBqmBK/_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/captide/-FVRvyiygpJBqmBK/_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/captide/-FVRvyiygpJBqmBK/_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/captide/-FVRvyiygpJBqmBK/_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/captide/-FVRvyiygpJBqmBK/_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/captide/-FVRvyiygpJBqmBK/_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/captide/-FVRvyiygpJBqmBK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Changes Snapshot - Captide API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with GET /api/v2/changes. Page through it with pageToken (each response\u0026#x27;s nextPageToken, until it is null), then follow the feed from cursor. Load companies first, then documents, and follow the feed from the cursor of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes. Unlike /documents/list, paging can\u0026#x27;t skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from GET /api/v2/documents/{id}.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Captide API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://captide.mintlify.app/_mintlify/api/og/v2?division=Changes\u0026amp;title=Changes+Snapshot\u0026amp;description=Every+document+or+company+the+changes+feed+covers%2C+as+it+is+now%3A+the+starting+copy+to+keep+up+to+date+with+%60GET+%2Fapi%2Fv2%2Fchanges%60.%0A%0A++++Page+through+it+with+%60pag\u0026amp;theme=9b0f99567cd7e39d13fdfb91\u0026amp;signature=9e7ad359480480ee996d12b5451fb6cd0870d3d305561d252ab45a6ef78aca85\">\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=\"Changes Snapshot - Captide API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with GET /api/v2/changes. Page through it with pageToken (each response\u0026#x27;s nextPageToken, until it is null), then follow the feed from cursor. Load companies first, then documents, and follow the feed from the cursor of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes. Unlike /documents/list, paging can\u0026#x27;t skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from GET /api/v2/documents/{id}.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://captide.mintlify.app/_mintlify/api/og/v2?division=Changes\u0026amp;title=Changes+Snapshot\u0026amp;description=Every+document+or+company+the+changes+feed+covers%2C+as+it+is+now%3A+the+starting+copy+to+keep+up+to+date+with+%60GET+%2Fapi%2Fv2%2Fchanges%60.%0A%0A++++Page+through+it+with+%60pag\u0026amp;theme=9b0f99567cd7e39d13fdfb91\u0026amp;signature=9e7ad359480480ee996d12b5451fb6cd0870d3d305561d252ab45a6ef78aca85\">\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/captide/-FVRvyiygpJBqmBK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Captide API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#478ef8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/changes_snapshot.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.captide.ai/#organization\",\"name\":\"Captide API\",\"url\":\"https://docs.captide.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/captide/9nTwxd7pkhCHGj3r/logo/light.svg?fit=max\u0026auto=format\u0026n=9nTwxd7pkhCHGj3r\u0026q=85\u0026s=f6615b1fe22f08cba979a10550c982df\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.captide.ai#website\",\"name\":\"Captide API\",\"url\":\"https://docs.captide.ai\",\"publisher\":{\"@id\":\"https://docs.captide.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot#webpage\",\"url\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot\",\"name\":\"Changes Snapshot\",\"description\":\"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with GET /api/v2/changes. Page through it with pageToken (each response's nextPageToken, until it is null), then follow the feed from cursor. Load companies first, then documents, and follow the feed from the cursor of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes. Unlike /documents/list, paging can't skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from GET /api/v2/documents/{id}.\",\"dateModified\":\"2026-11-04T20:17:46.711Z\",\"isPartOf\":{\"@id\":\"https://docs.captide.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Changes\",\"item\":\"https://docs.captide.ai/api-reference/endpoint/changes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Changes Snapshot\",\"item\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot#apireference\",\"headline\":\"Changes Snapshot\",\"name\":\"Changes Snapshot\",\"description\":\"Every document or company the changes feed covers, as it is now: the starting copy to keep up to date with GET /api/v2/changes. Page through it with pageToken (each response's nextPageToken, until it is null), then follow the feed from cursor. Load companies first, then documents, and follow the feed from the cursor of the first page you loaded. Changes made while you load come through the feed again; apply them as upserts and deletes. Unlike /documents/list, paging can't skip anything when documents are added or removed meanwhile, and documents dated in the future are included, as the feed includes them. Documents come without file links; get those from GET /api/v2/documents/{id}.\",\"url\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot\",\"mainEntityOfPage\":{\"@id\":\"https://docs.captide.ai/api-reference/endpoint/changes_snapshot#webpage\"},\"dateModified\":\"2026-11-04T20:17:46.711Z\",\"publisher\":{\"@id\":\"https://docs.captide.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.captide.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Captide API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Captide API","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Conventions","href":"/api-reference/versions"}]},{"group":"Companies","pages":[{"title":"Find Companies","openapi":"GET /api/v2/companies/list","href":"/api-reference/endpoint/companies"},{"title":"Search Companies","openapi":"GET /api/v2/companies/search","href":"/api-reference/endpoint/search_company"},{"title":"Get Company by ID","openapi":"GET /api/v2/companies/{id}","href":"/api-reference/endpoint/get_company"}]},{"group":"Documents","pages":[{"title":"Find Documents","openapi":"GET /api/v2/documents/list","href":"/api-reference/endpoint/documents"},{"title":"Get Document by ID","openapi":"GET /api/v2/documents/{id}","href":"/api-reference/endpoint/get_document"}]},{"group":"Agentic RAG","pages":[{"title":"Company Retrieval","openapi":"POST /api/v2/rag/company-retrieval","href":"/api-reference/endpoint/company_retrieval"},{"title":"Chunk Retrieval","openapi":"POST /api/v2/rag/chunks","href":"/api-reference/endpoint/chunks"},{"title":"Agent Response","openapi":"POST /api/v2/rag/agent-response","href":"/api-reference/endpoint/agent"},{"title":"Agent Response (Stream)","openapi":"POST /api/v2/rag/agent-response-stream","href":"/api-reference/endpoint/agent_stream"}]},{"group":"Changes","pages":[{"title":"List Changes","openapi":"GET /api/v2/changes","description":"Every change to the documents and companies the API shows, in order: new documents, documents whose metadata or files changed, documents removed from the API, and the same for companies. Use it to keep a copy of Captide's data up to date without re-reading the lists.\n\n To start:\n 1. Load your starting copy from `GET /api/v2/changes/snapshot`: companies, then documents. Keep the `cursor` of the first page you loaded.\n 2. From then on, call this endpoint with `after` set to that `cursor` (then to each response's `nextCursor`) every few minutes, and apply the changes in order. Changes made while you were loading the snapshot come through again, so apply them as upserts and deletes:\n - `document.created` / `company.created`: add it, or replace it if you have it.\n - `document.updated` / `company.updated`: replace it. `changedFields` says what changed and `previous` holds the old values. When a file changed (`originalFileUrl`, `markdownFileUrl`, `layoutJsonFileUrl`) or the document's `id` changed (a new version of its file), fetch it again with `GET /api/v2/documents/{id}`.\n - `document.deleted` / `company.deleted`: remove it, if you have it.\n\n A document is in the feed when `/documents/list` lists it, so a document that gains a category or a listable file appears as `document.created`. A document dated in the future is announced when it is added, although the list only shows it from its date. Changes are published about a minute after they are made.","href":"/api-reference/endpoint/changes"},{"title":"Changes Snapshot","openapi":"GET /api/v2/changes/snapshot","href":"/api-reference/endpoint/changes_snapshot"}]},{"group":"Webhooks","pages":[{"title":"Create Webhook","openapi":"POST /api/v2/webhooks","description":"Register a URL to receive new documents as Captide adds them.\n\n For each new document published in the last 7 days, Captide sends a `POST` to your URL with the document in the same format as `GET /api/v2/documents/{id}`. Set `documentCategories` to receive only some categories. See the Webhooks guide for headers, retries and how to respond.","href":"/api-reference/endpoint/webhook_create"},{"title":"List Webhooks","openapi":"GET /api/v2/webhooks","href":"/api-reference/endpoint/webhook_list"},{"title":"Get Webhook","openapi":"GET /api/v2/webhooks/{id}","href":"/api-reference/endpoint/webhook_get"},{"title":"Update Webhook","openapi":"PATCH /api/v2/webhooks/{id}","href":"/api-reference/endpoint/webhook_update"},{"title":"Delete Webhook","openapi":"DELETE /api/v2/webhooks/{id}","href":"/api-reference/endpoint/webhook_delete"}]}]}]},"basePath":"","title":"Changes Snapshot - Captide API","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-hfTk6MZX.js","utils-Bfp7HcY4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D8dSW7yV.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CFgQXcZO.js","snippetPresets-dMW1-pV3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DyrCOido.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bwwdcyh3.js","shallow-drVXTg79.js","getApiPlaygroundDisplay-GMPxUzWV.js","CodeSnippet-wTmV0wP6.js","CodeSnippets-D_QxCJEq.js","Page-BsZAA8xk.js","getPastedJson-Dev-X0Xy.js","icon-7L2WL0jD.js","MethodPill-Ble59Dl_.js","DuplicateIcon-r-98uLGh.js","createIcon-DaFzipjW.js","DynamicMarkdown-Jk8YAWGN.js","SectionHeading-nLgrCDOg.js","axios-vUo_bRtp.js","Markdown-_QGow1Wo.js","clsx-v8ssfMzu.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CjboTi0T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DkAyo-p5.js"]}