{
"status": "error",
"message": "start_date is older than the earliest available change. Changes are kept for 90 days.",
"details": {
"earliestAvailableDate": "2026-05-26T00:00:00.000Z"
}
}
{
"error": "Unauthorized. You shouldn't be here."
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "dataChangeFeed",
"currentTier": "supporter",
"requiredTier": "professional",
"upgradeUrl": "https://countrystatecity.in/pricing"
}
}
{
"error": "Daily usage limit exceeded. Please try again tomorrow or contact support for higher limits.",
"limit": 100,
"period": "daily",
"tier": "community",
"upgradeUrl": "https://countrystatecity.in/pricing"
}
Data Changes
Data Change Feed
Keep your copy of Country State City data current without downloading the full dataset again
{
"status": "error",
"message": "start_date is older than the earliest available change. Changes are kept for 90 days.",
"details": {
"earliestAvailableDate": "2026-05-26T00:00:00.000Z"
}
}
{
"error": "Unauthorized. You shouldn't be here."
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "dataChangeFeed",
"currentTier": "supporter",
"requiredTier": "professional",
"upgradeUrl": "https://countrystatecity.in/pricing"
}
}
{
"error": "Daily usage limit exceeded. Please try again tomorrow or contact support for higher limits.",
"limit": 100,
"period": "daily",
"tier": "community",
"upgradeUrl": "https://countrystatecity.in/pricing"
}
If your app stores Country State City data in its own database, a full download is wasteful when only a few places changed. The change feed returns the countries, states, and cities that were added, removed, or updated so you can apply only those changes.
Available on Professional and Business plans. Returns 403 on Community, Starter, Supporter, and Legacy plans. Compare plans to add the change feed to your API key.
When to use it
Use the feed to keep a local search index, checkout form, analytics database, or cached copy up to date. Every change has a stable change_id, the affected place_id, and the data_version that produced it.Changes are available for 90 days. Run your sync regularly and save the change_id values you have applied so retrying a page cannot create duplicates.
Change types
Value
Meaning
added
A new place was added.
removed
A place was removed.
renamed
Its name changed.
place_group_changed
Its region, administrative type, or city kind changed.
parent_changed
A state moved to another country, or a city moved to another state/country.
coordinates_changed
Its latitude or longitude changed.
other_fields_changed
Another public field changed.
When several fields change in one release, the record has one main change_type, but old_values and new_values include every changed field.
Response
The response below illustrates the schema; it is not a historical changelog.The API returns changes from oldest to newest.
old_values and new_values contain only fields allowed for your API key. The endpoint is not cached, so it does not return ETag or X-Cache.
Read every page safely
The first request fixes the result set. Later pages do not suddenly include a release published while you are syncing. After the last page, start a new request to collect newer changes.For page two and later, send the token by itself. Do not change the original filters.
JavaScript
let url = new URL('https://api.countrystatecity.in/v1/changes');url.searchParams.set('start_date', new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString());url.searchParams.set('country_code', 'IN');url.searchParams.set('limit', '100');while (url) { const response = await fetch(url, { headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }); if (!response.ok) throw new Error(await response.text()); const page = await response.json(); for (const change of page.results) { console.log(change); // Apply it to your database and save change.change_id. } url = page.next_page_token ? new URL(`https://api.countrystatecity.in/v1/changes?next_page_token=${encodeURIComponent(page.next_page_token)}`) : null;}
If start_date is older than the retained data, use details.earliestAvailableDate to restart from the oldest available change:
400 - Start date is too old
{ "status": "error", "message": "start_date is older than the earliest available change. Changes are kept for 90 days.", "details": { "earliestAvailableDate": "2026-05-26T00:00:00.000Z" }}
If a token expires, is changed, or is invalid, start again with start_date and no token. Reusing saved change_id values prevents duplicate work. If your sync has been offline for more than 90 days, download a fresh full dataset before continuing.Lower plans receive a plan-gate response:
403 - Professional plan required
{ "status": "error", "message": "This feature is not available on your current plan.", "details": { "feature": "dataChangeFeed", "currentTier": "supporter", "requiredTier": "professional", "upgradeUrl": "https://app.countrystatecity.in/pricing" }}
Start syncing changes
Compare API plans
Choose Professional or Business to keep your database current with small incremental requests.
Get Data Version
Check which dataset release your API responses use.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Country State City Documentation","description":"Documentation for the Country State City ecosystem: a REST API, downloadable database and tools covering 250 countries, 5,000+ states and 150,000+ cities with ISO codes, coordinates, timezones and currencies.","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1E40AF"},"logo":{"light":"https://mintcdn.com/webbywonder/DXb6lzT49e7Mz1Kh/logo/csc-docs-logo-dark.svg?fit=max\u0026auto=format\u0026n=DXb6lzT49e7Mz1Kh\u0026q=85\u0026s=893eeadd293f0443a7f2b192eb9b59d0","dark":"https://mintcdn.com/webbywonder/DXb6lzT49e7Mz1Kh/logo/csc-docs-logo-light.svg?fit=max\u0026auto=format\u0026n=DXb6lzT49e7Mz1Kh\u0026q=85\u0026s=cff7bfba805966e45c27a602c96e8252"},"favicon":"https://mintcdn.com/webbywonder/fAkIAEvO-IGHwy4I/favicon.svg?fit=max\u0026auto=format\u0026n=fAkIAEvO-IGHwy4I\u0026q=85\u0026s=1b0ea88bfb2dcdc3ed92888be25695ae","api":{"openapi":"https://raw.githubusercontent.com/dr5hn/csc-swagger-playground/main/config.json","playground":{"display":"interactive"},"mdx":{"auth":{"method":"key","name":"X-CSCAPI-KEY"},"server":"https://api.countrystatecity.in/v1"}},"navbar":{"links":[{"href":"https://countrystatecity.in","label":"Home"},{"href":"https://countrystatecity.in/pricing","label":"Pricing"},{"href":"https://countrystatecity.org","label":"Encyclopedia"}],"primary":{"type":"button","label":"Get API Key","href":"https://countrystatecity.in/product/api/"}},"footer":{"socials":{"github":"https://github.com/dr5hn/countries-states-cities-database","linkedin":"https://www.linkedin.com/in/dr5hn","x":"https://x.com/dr5hn"},"links":[{"header":"Products","items":[{"label":"REST API","href":"https://countrystatecity.in/product/api"},{"label":"Database","href":"https://countrystatecity.in/product/database"},{"label":"Export Tool","href":"https://export.countrystatecity.in/"},{"label":"Update Tool","href":"https://countrystatecity.in/product/update-tool"}]},{"header":"Resources","items":[{"label":"API Playground","href":"https://playground.countrystatecity.in/"},{"label":"Live Demo","href":"https://demo.countrystatecity.in/"},{"label":"Products","href":"https://countrystatecity.in/ecosystem"},{"label":"Changelog","href":"/changelog"},{"label":"Status","href":"https://status.countrystatecity.in/"}]},{"header":"Company","items":[{"label":"About","href":"https://countrystatecity.in/about"},{"label":"Pricing","href":"https://countrystatecity.in/pricing"},{"label":"Contact","href":"https://countrystatecity.in/contact"},{"label":"Encyclopedia","href":"https://countrystatecity.org/"}]}]},"search":{"prompt":"Search the documentation..."},"seo":{"metatags":{"og:site_name":"Country State City Docs","og:image":"https://docs.countrystatecity.in/images/hero-light.png","twitter:card":"summary_large_image","twitter:site":"@dr5hn","twitter:image":"https://docs.countrystatecity.in/images/hero-light.png","keywords":"country state city API, countries API, states API, cities API, ISO 3166, geographical database, location dropdown"}},"integrations":{"clarity":{"projectId":"z4ojfuzvou"},"ga4":{"measurementId":"G-7LDSKYGZJB"}},"banner":{"content":"[**MakeMySiteLive** Publish your website in under 2 minutes *New*](https://makemysitelive.com/?utm_source=csc-docs\u0026utm_medium=banner\u0026utm_campaign=cross-promo\u0026utm_content=makemysitelive) [**RemoteGigs** Find remote jobs and gigs](https://remotegig.in/?utm_source=csc-docs\u0026utm_medium=banner\u0026utm_campaign=cross-promo\u0026utm_content=remotegig)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"webbywonder","hasAudioNarration":false,"actualSubdomain":"webbywonder","customDomains":["docs.countrystatecity.in"],"gitSource":{"type":"github","owner":"dr5hn","repo":"csc-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af82140f773a48258624b61","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API Reference","count":31},{"language":"default","tag":"Database","count":14},{"language":"default","tag":"API Guides","count":13},{"language":"default","tag":"Tools","count":12},{"language":"default","tag":"Installation Guides","count":7},{"language":"default","tag":"SDKs \u0026 Examples","count":6},{"language":"default","tag":"Database Documentation","count":6},{"language":"default","tag":"Update Tool","count":6},{"language":"default","tag":"Regions","count":5},{"language":"default","tag":"Export Tool","count":5}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":true,"maxResults":10}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"[email protected]"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","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":"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":"editor-metadata","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},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"#banner{background:#eef4fb;border-bottom:1px solid #dbe5f1;padding-top:6px;padding-bottom:6px}#banner>div{max-width:100%}#banner p{display:flex;flex-wrap:nowrap;align-items:center;justify-content:center;gap:8px 12px;margin:0}#banner a{display:inline-flex;align-items:center;gap:8px;padding:4px 12px 4px 4px;background:#ffffff;border:1px solid #dbe5f1;border-radius:999px;flex:none;font-family:Inter, ui-sans-serif, system-ui, -apple-system, 'Segoe UI', sans-serif;font-size:13px;font-weight:400;text-decoration:none;white-space:nowrap;transition:box-shadow 0.15s ease, border-color 0.15s ease}#banner a:hover{border-color:#bcd0ea;box-shadow:0 1px 6px rgba(37, 99, 235, 0.15)}#banner a,#banner a *{-webkit-text-fill-color:#475569}#banner a [data-streamdown=\"strong\"]{white-space:nowrap;font-weight:600;-webkit-text-fill-color:#0f172a}#banner a::before{content:'';flex:none;width:24px;height:24px;background:no-repeat center / cover;border-radius:7px}#banner a:nth-of-type(1)::before{background-image:url('/images/makemysitelive-icon.png')}#banner a:nth-of-type(2)::before{background-image:url('/images/remotegigs-icon.png');border-radius:50%}#banner a::after{content:'';flex:none;width:12px;height:12px;background-color:#2563eb;-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M7 17 17 7M8 7h9v9'/%3E%3C/svg%3E\") no-repeat center / contain;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M7 17 17 7M8 7h9v9'/%3E%3C/svg%3E\") no-repeat center / contain}#banner a em{padding:1px 8px;background:#fef3c7;border-radius:999px;font-size:11px;font-style:normal;font-weight:500;-webkit-text-fill-color:#92400e}#banner button{right:6px;opacity:0.6}#banner button:hover{opacity:1;background:rgba(15, 23, 42, 0.08)}#banner button svg path{stroke:#334155}@media (min-width: 901px) and (max-width: 1024px){#banner p{gap:8px;padding:0 40px}#banner a{gap:6px;padding:4px 10px 4px 4px;font-size:12.5px}}@media (min-width: 768px) and (max-width: 900px){#banner p{gap:6px;padding:0 32px}#banner a{gap:6px;padding:3px 10px 3px 3px;font-size:12px}#banner a::before{width:20px;height:20px}#banner a::after{width:10px;height:10px}#banner a em{display:none}}@media (max-width: 767px){#banner p{gap:6px;padding:0 28px}#banner a{font-size:0;gap:5px;padding:3px 8px 3px 3px}#banner a *:not([data-streamdown=\"strong\"]){font-size:0}#banner a [data-streamdown=\"strong\"]{font-size:12px}#banner a::before{width:20px;height:20px}#banner a::after{width:10px;height:10px}#banner a em{display:none}}@media (max-width: 400px){#banner a{gap:3px;padding-right:6px}#banner a [data-streamdown=\"strong\"]{font-size:11px}#banner a::after{display:none}}.dark #banner{background:#0f1b33;border-bottom-color:#1e2d4a}.dark #banner a{background:#16233f;border-color:#28395c}.dark #banner a,.dark #banner a *{-webkit-text-fill-color:#cbd5e1}.dark #banner a [data-streamdown=\"strong\"]{-webkit-text-fill-color:#f1f5f9}.dark #banner a::after{background-color:#60a5fa}.dark #banner a em{background:#3b2f0b;-webkit-text-fill-color:#fcd34d}.dark #banner button:hover{background:rgba(255, 255, 255, 0.1)}.dark #banner button svg path{stroke:#cbd5e1}"}]}
{"page":{"pagePath":"api/endpoints/get-data-changes","slug":"/api/endpoints/get-data-changes","pageMetadata":{"title":"Data Change Feed","openapi":"GET /changes","description":"Keep your copy of Country State City data current without downloading the full dataset again","href":"/api/endpoints/get-data-changes"},"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: \"Keep your copy of Country State City data current without downloading the full dataset again\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Info,Note,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`If your app stores Country State City data in its own database, a full download is wasteful when only a few places changed. The change feed returns the countries, states, and cities that were added, removed, or updated so you can apply only those changes.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Available on Professional and Business plans.`}),` Returns `,_jsx(_components.code,{children:`403`}),` on Community, Starter, Supporter, and Legacy plans. `,_jsx(_components.a,{href:`https://countrystatecity.in/pricing?source=docs\u0026campaign=data_change_feed`,children:`Compare plans`}),` to add the change feed to your API key.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`when-to-use-it`,children:`When to use it`}),`\n`,_jsxs(_components.p,{children:[`Use the feed to keep a local search index, checkout form, analytics database, or cached copy up to date. Every change has a stable `,_jsx(_components.code,{children:`change_id`}),`, the affected `,_jsx(_components.code,{children:`place_id`}),`, and the `,_jsx(_components.code,{children:`data_version`}),` that produced it.`]}),`\n`,_jsxs(_components.p,{children:[`Changes are available for `,_jsx(_components.strong,{children:`90 days`}),`. Run your sync regularly and save the `,_jsx(_components.code,{children:`change_id`}),` values you have applied so retrying a page cannot create duplicates.`]}),`\n`,_jsx(Heading,{level:`2`,id:`change-types`,children:`Change types`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`added`})}),_jsx(_components.td,{children:`A new place was added.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`removed`})}),_jsx(_components.td,{children:`A place was removed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`renamed`})}),_jsx(_components.td,{children:`Its name changed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`place_group_changed`})}),_jsx(_components.td,{children:`Its region, administrative type, or city kind changed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`parent_changed`})}),_jsx(_components.td,{children:`A state moved to another country, or a city moved to another state/country.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`coordinates_changed`})}),_jsx(_components.td,{children:`Its latitude or longitude changed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`other_fields_changed`})}),_jsx(_components.td,{children:`Another public field changed.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When several fields change in one release, the record has one main `,_jsx(_components.code,{children:`change_type`}),`, but `,_jsx(_components.code,{children:`old_values`}),` and `,_jsx(_components.code,{children:`new_values`}),` include every changed field.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`The response below illustrates the schema; it is not a historical changelog.`}),`\n`,_jsx(_components.p,{children:`The API returns changes from oldest to newest.`}),`\n`,_jsx(CodeBlock,{filename:`200 - Renamed city`,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"change_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6b30c790-c46f-4a0f-b7f2-ea1a1a9d8362\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data_version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"v3.2-export.7-2026.08.24\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"changed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-24T08:15:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"place_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"city\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"place_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"132649\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"change_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"renamed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"old_values\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bombay\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"new_values\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mumbai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"next_page_token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"H2gwOstvc3hy5O7cW1bK0T5S1m4f8h2wYQ\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`old_values`}),` and `,_jsx(_components.code,{children:`new_values`}),` contain only fields allowed for your API key. The endpoint is not cached, so it does not return `,_jsx(_components.code,{children:`ETag`}),` or `,_jsx(_components.code,{children:`X-Cache`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`read-every-page-safely`,children:`Read every page safely`}),`\n`,_jsx(_components.p,{children:`The first request fixes the result set. Later pages do not suddenly include a release published while you are syncing. After the last page, start a new request to collect newer changes.`}),`\n`,_jsx(_components.p,{children:`For page two and later, send the token by itself. Do not change the original filters.`}),`\n`,_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`22`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`22`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` URL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.countrystatecity.in/v1/changes'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`searchParams`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`set`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'start_date'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Date`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Date`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`now`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 7`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 24`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 60`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 60`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`).`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`toISOString`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`());`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`searchParams`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`set`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'country_code'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'IN'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`searchParams`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`set`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'limit'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'100'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`while`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'X-CSCAPI-KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ok`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`throw`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`text`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`());`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` page`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` change`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` of`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` page`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`results`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`change`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Apply it to your database and save change.change_id.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` page`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`next_page_token`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ?`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` URL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`https://api.countrystatecity.in/v1/changes?next_page_token=\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`encodeURIComponent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`page`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`next_page_token`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`)`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` :`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`recover-from-errors`,children:`Recover from errors`}),`\n`,_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`start_date`}),` is older than the retained data, use `,_jsx(_components.code,{children:`details.earliestAvailableDate`}),` to restart from the oldest available change:`]}),`\n`,_jsx(CodeBlock,{filename:`400 - Start date is too old`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"start_date is older than the earliest available change. Changes are kept for 90 days.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"details\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"earliestAvailableDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-05-26T00:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If a token expires, is changed, or is invalid, start again with `,_jsx(_components.code,{children:`start_date`}),` and no token. Reusing saved `,_jsx(_components.code,{children:`change_id`}),` values prevents duplicate work. If your sync has been offline for more than 90 days, download a fresh full dataset before continuing.`]}),`\n`,_jsx(_components.p,{children:`Lower plans receive a plan-gate response:`}),`\n`,_jsx(CodeBlock,{filename:`403 - Professional plan required`,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"This feature is not available on your current plan.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"details\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"feature\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dataChangeFeed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currentTier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"supporter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requiredTier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"professional\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"upgradeUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://app.countrystatecity.in/pricing\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`start-syncing-changes`,children:`Start syncing changes`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Compare API plans`,icon:`credit-card`,href:`https://countrystatecity.in/pricing?source=docs\u0026campaign=data_change_feed`,children:_jsx(_components.p,{children:`Choose Professional or Business to keep your database current with small incremental requests.`})}),_jsx(Card,{title:`Get Data Version`,icon:`clock-rotate-left`,href:`/api/endpoints/get-data-version`,children:_jsx(_components.p,{children:`Check which dataset release your API responses use.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Data Change Feed","openapi":"GET /changes","description":"Keep your copy of Country State City data current without downloading the full dataset again","href":"/api/endpoints/get-data-changes"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[384,389,"RequestExample,Table"],[691,708,"RequestExample)_missingMdxReference(`RequestExample`,true);if(!Table)_missingMdx"],[25129,25569,"_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_"],[25760,25988,"shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_js"],[26074,26228,"953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_co"],[26302,26396," 'https://api.countrystatecity.in/v1/changes?country_code=IN\u0026limit=100'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\"],[26496,26651,"0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_co"],[26725,28365," 'X-CSCAPI-KEY: YOUR_API_KEY'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`11`,language:`python`,ch"],[28569,28807,"python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`11`,children:[_jsxs(_compo"],[28884,28948,"CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_"],[29024,29217," requests`})]}),`\n`,"],[29306,29373,"CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_co"],[29447,29606," datetime `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_componen"],[29674,31608," datetime, timedelta, timezone`})]}),`\n`"],[31648,31660,"}),`\n`,_jsxs(_components.span,{className:`line`,children:[_j"],[31740,31820,"start_date `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.s"],[31884,32932," (datetime.now(timezone.utc) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` timedelta(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`days`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`7`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)).isoformat()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.countrystatecity.in/v1/changes'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'start_date'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: start_date, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'country_code'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'IN'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'X-CSCAPI-KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response.raise_for_status()`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`page `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`recover-from-errors`,children:`Recover from errors`}),`\n`,_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`start_date`}),` is older than the retained data, use `,_jsx(_components.code,{children:`details.earliestAvailableDate`}),` to restart from the oldest available change:`]}),`\n`,_jsx(CodeBlock,{filename:`400 - Start date is too old`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"start_date is older than the earliest available change. Changes are kept for 90 days.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"details\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"earliestAvailableDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-05-26T00:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If a token expires, is changed, or is invalid, start again with `,_jsx(_components.code,{children:`start_date`}),` and no token. Reusing saved `,_jsx(_components.code,{children:`change_id`}),` values prevents duplicate work. If your sync has been offline for more than 90 days, download a fresh full dataset before continuing.`]}),`\n`,_jsx(_components.p,{children:`Lower plans receive a plan-gate response:`}),`\n`,_jsx(CodeBlock,{filename:`403 - Professional plan required`,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"This feature is not available on your current plan.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"details\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"feature\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dataChangeFeed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currentTier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"supporter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requiredTier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"professional\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"upgradeUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://app.countrystatecity.in/pricing\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`start-syncing-changes`,children:`Start syncing changes`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Compare API plans`,icon:`credit-card`,href:`https://countrystatecity.in/pricing?source=docs\u0026campaign=data_change_feed`,children:_jsx(_components.p,{children:`Choose Professional or Business to keep your database current with small incremental requests.`})}),_jsx(Card,{title:`Get Data Version`,icon:`clock-rotate-left`,href:`/api/endpoints/get-data-version`,children:_jsx(_components.p,{children:`Check which dataset release your API responses use.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"When to use it","slug":"when-to-use-it","depth":2,"children":[]},{"title":"Change types","slug":"change-types","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Read every page safely","slug":"read-every-page-safely","depth":2,"children":[]},{"title":"Recover from errors","slug":"recover-from-errors","depth":2,"children":[]},{"title":"Start syncing changes","slug":"start-syncing-changes","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.countrystatecity.in/v1/changes?country_code=IN\u0026#x26;limit=100'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'X-CSCAPI-KEY: YOUR_API_KEY'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"11\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">from\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> datetime \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> datetime, timedelta, timezone\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">start_date \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (datetime.now(timezone.utc) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">-\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> timedelta(\u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">days\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">7\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)).isoformat()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.get(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.countrystatecity.in/v1/changes'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'start_date'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: start_date, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'country_code'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'IN'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'X-CSCAPI-KEY'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'YOUR_API_KEY'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response.raise_for_status()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">page \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json()\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Changes"],"summary":"List data changes","description":"Keep your copy of Country State City data current without downloading the full dataset again","operationId":"listChanges","parameters":["3812e897-df45-433c-8f7f-eec27bd38764","2d2f6951-0885-4923-9b11-5fdda433a885","ffdadce0-7e70-45df-be17-b5b8a981f867","c57822f2-0875-4ad0-aafc-6464df7115ae","e8e84f5c-8333-4d65-97ce-553c05d42226","d5e010e5-5c32-442c-a229-0fe7bebf0c9c"],"responses":{"200":"df67f897-2fa6-4869-b350-34d7d5208d89","400":"8d6f1c3c-4925-4961-8019-6e4ffbb0f708","401":"0522397c-28b2-4777-b48d-1f1bab7543d8","403":"d71f0082-6f1d-41aa-bf4b-dc61bdb12654","429":"44075c06-149f-4c43-9f79-fae475e16cec"},"security":["b326ce42-4167-48b3-b853-a25b73371491"],"method":"get","type":"path","servers":["8053fe64-a420-4986-ab18-c4b2594158b3"],"path":"/changes","baseUrlOptions":["https://api.countrystatecity.in/v1"],"title":"List data changes","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"dropdown":false,"language":"shellscript","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"shellscript","children":{"type":"code","key":null,"ref":null,"props":{"language":"shellscript","numberOfLines":"2","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#953800","--shiki-dark":"#DCDCAA"},"children":"curl"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'https://api.countrystatecity.in/v1/changes?country_code=IN\u0026limit=100'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -H"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'X-CSCAPI-KEY: YOUR_API_KEY'"}}]}},"\n"]}}}},"filename":"cURL"},{"dropdown":false,"language":"python","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"python","children":{"type":"code","key":null,"ref":null,"props":{"language":"python","numberOfLines":"11","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#C586C0"},"children":"import"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" requests"}}]}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#C586C0"},"children":"from"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" datetime "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#C586C0"},"children":"import"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" datetime, timedelta, timezone"}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"start_date "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" (datetime.now(timezone.utc) "}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D4D4D4"},"children":"-"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" timedelta("}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#953800","--shiki-dark":"#9CDCFE"},"children":"days"}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"7"}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":")).isoformat()"}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"response "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" requests.get("}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'https://api.countrystatecity.in/v1/changes'"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#953800","--shiki-dark":"#9CDCFE"},"children":" params"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'start_date'"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": start_date, "}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'country_code'"}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'IN'"}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"},"}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#953800","--shiki-dark":"#9CDCFE"},"children":" headers"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'X-CSCAPI-KEY'"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'YOUR_API_KEY'"}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"},"}}]}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":")"}}}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"response.raise_for_status()"}}}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"page "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" response.json()"}}]}},"\n"]}}}},"filename":"Python"}],"requestExampleType":"mdx","responseExampleType":"generated"},"dependencies":{"parameters":{"3812e897-df45-433c-8f7f-eec27bd38764":{"name":"start_date","in":"query","description":"Return changes at or after this ISO 8601 timestamp. A date older than the earliest retained change returns `400` with `details.earliestAvailableDate`.","required":false,"schema":{"type":"string","format":"date-time","example":"2026-08-01T00:00:00Z","isRequired":false,"description":"Return changes at or after this ISO 8601 timestamp. A date older than the earliest retained change returns `400` with `details.earliestAvailableDate`.","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"2d2f6951-0885-4923-9b11-5fdda433a885":{"name":"place_type","in":"query","description":"Return changes for one place type","required":false,"schema":{"type":"string","enum":["country","state","city"],"example":"city","isRequired":false,"description":"Return changes for one place type","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"ffdadce0-7e70-45df-be17-b5b8a981f867":{"name":"country_code","in":"query","description":"Return changes for a country and its states and cities. Uses an ISO 3166-1 alpha-2 code.","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Za-z]{2}$","example":"IN","isRequired":false,"description":"Return changes for a country and its states and cities. Uses an ISO 3166-1 alpha-2 code.","uniqueKey":"","typeLabel":"string"}},"c57822f2-0875-4ad0-aafc-6464df7115ae":{"name":"change_type","in":"query","description":"Return one kind of change","required":false,"schema":{"type":"string","enum":["added","removed","renamed","place_group_changed","parent_changed","coordinates_changed","other_fields_changed"],"example":"renamed","isRequired":false,"description":"Return one kind of change","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"e8e84f5c-8333-4d65-97ce-553c05d42226":{"name":"limit","in":"query","description":"Maximum records per page (1–100)","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50,"isRequired":false,"description":"Maximum records per page (1–100)","uniqueKey":"","typeLabel":"integer"}},"d5e010e5-5c32-442c-a229-0fe7bebf0c9c":{"name":"next_page_token","in":"query","description":"Opaque cursor returned by the previous page. It expires after 24 hours. Omit the original filters, or resend all of them unchanged.","required":false,"schema":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^[A-Za-z0-9_-]+$","isRequired":false,"description":"Opaque cursor returned by the previous page. It expires after 24 hours. Omit the original filters, or resend all of them unchanged.","uniqueKey":"","typeLabel":"string"}}},"responses":{"df67f897-2fa6-4869-b350-34d7d5208d89":{"description":"A page from the fixed change-feed snapshot. This endpoint is not cached and does not return `Cache-Control`, `ETag`, or `X-Cache`.","headers":{"X-Request-ID":{"description":"Unique ID for this request","schema":{"type":"string","format":"uuid","example":"8b4c01b8-60f1-4c29-a105-8dc65ca9925e"}},"X-CSC-Data-Version":{"description":"Current dataset version. Present when version metadata is available.","schema":{"type":"string","example":"v3.2-export.7-2026.08.24"}},"X-CSC-Data-Updated-At":{"description":"When the current dataset version was published. Present when version metadata is available.","schema":{"type":"string","format":"date-time","example":"2026-08-24T08:15:00.000Z"}},"X-CSC-Plan":{"description":"Your current pricing tier","schema":{"type":"string","enum":["community","starter","supporter","professional","business","legacy","custom"],"example":"supporter"}},"X-CSC-Daily-Used":{"description":"Number of requests used today","schema":{"type":"integer","example":42}},"X-CSC-Daily-Limit":{"description":"Your daily request limit (or 'unlimited' for custom plans)","schema":{"type":"string","example":"1000"}},"X-CSC-Monthly-Used":{"description":"Number of requests used this month","schema":{"type":"integer","example":850}},"X-CSC-Monthly-Limit":{"description":"Your monthly request limit (or 'unlimited' for custom plans)","schema":{"type":"string","example":"30000"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","description":"One recorded change. Fields inside `old_values` and `new_values` are filtered to the caller's data access level.","properties":{"change_id":{"type":"string","format":"uuid","description":"Unique ID for this change","example":"6b30c790-c46f-4a0f-b7f2-ea1a1a9d8362","isRequired":true,"uniqueKey":"results.items.[INDEX].change_id","typeLabel":"string\u003cuuid>"},"data_version":{"type":"string","description":"Dataset release that produced this change","example":"v3.2-export.7-2026.08.24","isRequired":true,"uniqueKey":"results.items.[INDEX].data_version","typeLabel":"string"},"changed_at":{"type":"string","format":"date-time","description":"When the release was recorded","example":"2026-08-24T08:15:00.000Z","isRequired":true,"uniqueKey":"results.items.[INDEX].changed_at","typeLabel":"string\u003cdate-time>"},"place_type":{"type":"string","enum":["country","state","city"],"example":"city","isRequired":true,"uniqueKey":"results.items.[INDEX].place_type","typeLabel":"enum\u003cstring>"},"place_id":{"type":"string","description":"Stable ID of the changed place","example":"57606","isRequired":true,"uniqueKey":"results.items.[INDEX].place_id","typeLabel":"string"},"change_type":{"type":"string","enum":["added","removed","renamed","place_group_changed","parent_changed","coordinates_changed","other_fields_changed"],"example":"renamed","isRequired":true,"uniqueKey":"results.items.[INDEX].change_type","typeLabel":"enum\u003cstring>"},"old_values":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Values before the change. `null` for an added place.","isRequired":true,"uniqueKey":"results.items.[INDEX].old_values.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Values before the change. `null` for an added place.","isRequired":true,"uniqueKey":"results.items.[INDEX].old_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].old_values","typeLabel":"object | null"},"new_values":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Values after the change. `null` for a removed place.","isRequired":true,"uniqueKey":"results.items.[INDEX].new_values.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Values after the change. `null` for a removed place.","isRequired":true,"uniqueKey":"results.items.[INDEX].new_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].new_values","typeLabel":"object | null"}},"required":["change_id","data_version","changed_at","place_type","place_id","change_type","old_values","new_values"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"next_page_token":{"oneOf":[{"type":"string","maxLength":4096,"pattern":"^[A-Za-z0-9_-]+$","description":"Opaque cursor for the next page, or `null` after the last page.","isRequired":true,"uniqueKey":"next_page_token.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":4096,"pattern":"^[A-Za-z0-9_-]+$","description":"Opaque cursor for the next page, or `null` after the last page.","isRequired":true,"uniqueKey":"next_page_token.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_page_token","typeLabel":"string | null"}},"required":["results","next_page_token"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"change_id":"6b30c790-c46f-4a0f-b7f2-ea1a1a9d8362","data_version":"v3.2-export.7-2026.08.24","changed_at":"2026-08-24T08:15:00.000Z","place_type":"city","place_id":"57606","change_type":"renamed","old_values":{},"new_values":{}}],"next_page_token":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8d6f1c3c-4925-4961-8019-6e4ffbb0f708":{"description":"Invalid parameter or token, filters that disagree with the token, or a start date outside the retained window","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra context when available, including `earliestAvailableDate` for an expired retention window.","uniqueKey":"details","typeLabel":"object"}},"required":["status","message"],"uniqueKey":"","typeLabel":"object"},"example":{"status":"error","message":"start_date is older than the earliest available change. Changes are kept for 90 days.","details":{"earliestAvailableDate":"2026-05-26T00:00:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"start_date is older than the earliest available change. Changes are kept for 90 days.","details":{"earliestAvailableDate":"2026-05-26T00:00:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"0522397c-28b2-4777-b48d-1f1bab7543d8":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unauthorized. You shouldn't be here."},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized. You shouldn't be here."}}},"exampleType":"examples"}},"exampleType":"examples"},"d71f0082-6f1d-41aa-bf4b-dc61bdb12654":{"description":"The API key's plan does not include the data change feed. Professional is the standard required tier.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","properties":{"feature":{"type":"string","enum":["dataChangeFeed"],"isRequired":true,"uniqueKey":"details.feature","typeLabel":"enum\u003cstring>"},"currentTier":{"type":"string","isRequired":true,"uniqueKey":"details.currentTier","typeLabel":"string"},"requiredTier":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"details.requiredTier.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"details.requiredTier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.requiredTier","typeLabel":"string | null"},"upgradeUrl":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"details.upgradeUrl","typeLabel":"string\u003curi>"}},"required":["feature","currentTier","requiredTier","upgradeUrl"],"isRequired":true,"uniqueKey":"details","typeLabel":"object"}},"required":["status","message","details"],"uniqueKey":"","typeLabel":"object"},"example":{"status":"error","message":"This feature is not available on your current plan.","details":{"feature":"dataChangeFeed","currentTier":"supporter","requiredTier":"professional","upgradeUrl":"https://countrystatecity.in/pricing"}},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"This feature is not available on your current plan.","details":{"feature":"dataChangeFeed","currentTier":"supporter","requiredTier":"professional","upgradeUrl":"https://countrystatecity.in/pricing"}}}},"exampleType":"examples"}},"exampleType":"examples"},"44075c06-149f-4c43-9f79-fae475e16cec":{"description":"Daily or monthly usage limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Daily usage limit exceeded. Please try again tomorrow or contact support for higher limits.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"limit":{"type":"integer","description":"Your plan's limit for the exceeded period","example":100,"uniqueKey":"limit","typeLabel":"integer"},"period":{"type":"string","enum":["daily","monthly"],"example":"daily","uniqueKey":"period","typeLabel":"enum\u003cstring>"},"tier":{"type":"string","description":"Your current tier","example":"community","uniqueKey":"tier","typeLabel":"string"},"upgradeUrl":{"type":"string","description":"URL to upgrade your plan","example":"https://countrystatecity.in/pricing","uniqueKey":"upgradeUrl","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"Daily usage limit exceeded. Please try again tomorrow or contact support for higher limits.","limit":100,"period":"daily","tier":"community","upgradeUrl":"https://countrystatecity.in/pricing"},"examples":{"Example":{"title":"Example","value":{"error":"Daily usage limit exceeded. Please try again tomorrow or contact support for higher limits.","limit":100,"period":"daily","tier":"community","upgradeUrl":"https://countrystatecity.in/pricing"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"b326ce42-4167-48b3-b853-a25b73371491":{"ApiKeyAuth":{"type":"apiKey","description":"API key for authentication. Get your free key at [app.countrystatecity.in](https://app.countrystatecity.in).","name":"X-CSCAPI-KEY","in":"header","scopes":[]}}},"servers":{"8053fe64-a420-4986-ab18-c4b2594158b3":{"url":"https://api.countrystatecity.in/v1","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"API key for authentication. Get your free key at [app.countrystatecity.in](https://app.countrystatecity.in).","name":"X-CSCAPI-KEY","in":"header","scopes":[]},"schema":{"title":"X-CSCAPI-KEY","type":"string","description":"API key for authentication. Get your free key at [app.countrystatecity.in](https://app.countrystatecity.in).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-CSCAPI-KEY"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://raw.githubusercontent.com/dr5hn/csc-swagger-playground/main/config.json"},"subdomain":"webbywonder","siteName":"Country State City Documentation","title":"Data Change Feed - Country State City Documentation","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6af81dc74cc801deff6906e4","deploymentId":"68c5124ba1ff923c83a9da5f","questionText":"How long are changes available?","status":"active","generatedBy":"contextual","path":"api/endpoints/get-data-changes","createdAt":"2026-11-14T08:37:27.678Z","updatedAt":"2026-11-14T08:37:27.678Z","__v":0},{"_id":"6af81dc74cc801deff6906e2","deploymentId":"68c5124ba1ff923c83a9da5f","questionText":"How do I sync data changes?","status":"active","generatedBy":"contextual","path":"api/endpoints/get-data-changes","createdAt":"2026-11-14T08:37:27.678Z","updatedAt":"2026-11-14T08:37:27.678Z","__v":0},{"_id":"6af81dc74cc801deff6906e3","deploymentId":"68c5124ba1ff923c83a9da5f","questionText":"What change types are tracked?","status":"active","generatedBy":"contextual","path":"api/endpoints/get-data-changes","createdAt":"2026-11-14T08:37:27.678Z","updatedAt":"2026-11-14T08:37:27.678Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[{"tab":"Home"},{"tab":"API Guides"},{"tab":"API Reference"},{"tab":"Tools"},{"tab":"Database"}]},"lastModified":"2026-11-14T08:37:23.886Z","originalFileLocation":"api/endpoints/get-data-changes.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=\"Keep your copy of Country State City data current without downloading the full dataset again\">\u003cmeta data-mint-head name=\"keywords\" content=\"country state city API, countries API, states API, cities API, ISO 3166, geographical database, location dropdown\">\u003cmeta data-mint-head name=\"application-name\" content=\"Country State City Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/webbywonder/QCoQSc7Hfg85lHKO/_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/webbywonder/QCoQSc7Hfg85lHKO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/webbywonder/QCoQSc7Hfg85lHKO/_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/webbywonder/QCoQSc7Hfg85lHKO/_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/webbywonder/QCoQSc7Hfg85lHKO/_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/webbywonder/QCoQSc7Hfg85lHKO/_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/webbywonder/QCoQSc7Hfg85lHKO/_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/webbywonder/QCoQSc7Hfg85lHKO/_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/webbywonder/QCoQSc7Hfg85lHKO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Data Change Feed - Country State City Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Keep your copy of Country State City data current without downloading the full dataset again\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Country State City Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.countrystatecity.in/api/endpoints/get-data-changes\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.countrystatecity.in/images/hero-light.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Data Change Feed - Country State City Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Keep your copy of Country State City data current without downloading the full dataset again\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.countrystatecity.in/images/hero-light.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/webbywonder/QCoQSc7Hfg85lHKO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Country State City Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.countrystatecity.in/api/endpoints/get-data-changes\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/endpoints/get-data-changes.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.countrystatecity.in/#organization\",\"name\":\"Country State City Documentation\",\"url\":\"https://docs.countrystatecity.in\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/webbywonder/DXb6lzT49e7Mz1Kh/logo/csc-docs-logo-dark.svg?fit=max\u0026auto=format\u0026n=DXb6lzT49e7Mz1Kh\u0026q=85\u0026s=893eeadd293f0443a7f2b192eb9b59d0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.countrystatecity.in#website\",\"name\":\"Country State City Documentation\",\"url\":\"https://docs.countrystatecity.in\",\"publisher\":{\"@id\":\"https://docs.countrystatecity.in/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes#webpage\",\"url\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes\",\"name\":\"Data Change Feed\",\"description\":\"Keep your copy of Country State City data current without downloading the full dataset again\",\"dateModified\":\"2026-11-14T08:37:23.886Z\",\"isPartOf\":{\"@id\":\"https://docs.countrystatecity.in#website\"},\"breadcrumb\":{\"@id\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Country State City Documentation\",\"item\":\"https://docs.countrystatecity.in\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Data Change Feed\",\"item\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes#apireference\",\"headline\":\"Data Change Feed\",\"name\":\"Data Change Feed\",\"description\":\"Keep your copy of Country State City data current without downloading the full dataset again\",\"url\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes\",\"mainEntityOfPage\":{\"@id\":\"https://docs.countrystatecity.in/api/endpoints/get-data-changes#webpage\"},\"image\":\"https://docs.countrystatecity.in/images/hero-light.png\",\"dateModified\":\"2026-11-14T08:37:23.886Z\",\"publisher\":{\"@id\":\"https://docs.countrystatecity.in/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.countrystatecity.in#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Country State City Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Country State City Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/endpoints/get-data-changes.md","siteName":"Country State City Documentation","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"API Guides","icon":"book","pages":[{"title":"API Guides","href":"/api/introduction"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Countries","icon":"earth-americas","pages":[{"title":"Get All Countries","openapi":"GET /countries","href":"/api/endpoints/get-all-countries"},{"title":"Get Country Details","openapi":"GET /countries/{ciso}","href":"/api/endpoints/get-country-details"}]},{"group":"States","icon":"map","pages":[{"title":"Get All States","openapi":"GET /states","href":"/api/endpoints/get-all-states"},{"title":"Get States by Country","openapi":"GET /countries/{ciso}/states","href":"/api/endpoints/get-states-by-country"},{"title":"Get State Details","openapi":"GET /countries/{ciso}/states/{siso}","href":"/api/endpoints/get-state-details"}]},{"group":"Cities","icon":"city","pages":[{"title":"Get Cities by Country","openapi":"GET /countries/{ciso}/cities","href":"/api/endpoints/get-cities-by-country"},{"title":"Get Cities by State","openapi":"GET /countries/{ciso}/states/{siso}/cities","href":"/api/endpoints/get-cities-by-state"}]},{"group":"Postcodes","icon":"envelope","pages":[{"title":"Get Postcode by Code","openapi":"GET /countries/{ciso}/postcodes/{code}","href":"/api/endpoints/get-postcode-by-code"},{"title":"Get Postcodes by Country","openapi":"GET /countries/{ciso}/postcodes","href":"/api/endpoints/get-postcodes-by-country"}]},{"group":"Regions","icon":"globe","pages":[{"title":"Get All Regions","openapi":"GET /regions","href":"/api/endpoints/get-all-regions"},{"title":"Get Region Details","openapi":"GET /regions/{id}","href":"/api/endpoints/get-region-details"},{"title":"Get Subregions by Region","openapi":"GET /regions/{id}/subregions","href":"/api/endpoints/get-subregions-by-region"},{"title":"Get Subregion Details","openapi":"GET /subregions/{id}","href":"/api/endpoints/get-subregion-details"},{"title":"Get Countries by Subregion","openapi":"GET /subregions/{id}/countries","href":"/api/endpoints/get-countries-by-subregion"}]},{"group":"Timezones","icon":"clock","pages":[{"title":"Get Timezone by Country","openapi":"GET /timezone/{ciso}","href":"/api/endpoints/get-timezone-by-country"},{"title":"Get Timezone by State","openapi":"GET /timezone/{ciso}/{siso}","href":"/api/endpoints/get-timezone-by-state"},{"title":"Get Timezone by City","openapi":"GET /timezone/{ciso}/{siso}/{city_id}","href":"/api/endpoints/get-timezone-by-city"}]},{"group":"Currencies","icon":"coins","pages":[{"title":"List All Currencies","openapi":"GET /currency","href":"/api/endpoints/list-all-currencies"},{"title":"Get Currency by Country","openapi":"GET /currency/{ciso}","href":"/api/endpoints/get-currency-by-country"}]},{"group":"Phone","icon":"phone","pages":[{"title":"List Dial Codes","openapi":"GET /phone","href":"/api/endpoints/list-dial-codes"},{"title":"Get Dial Code by Country","openapi":"GET /phone/{ciso}","href":"/api/endpoints/get-dial-code-by-country"},{"title":"Parse Phone Number","openapi":"GET /phone/parse","href":"/api/endpoints/parse-phone-number"}]},{"group":"ISO Codes","icon":"hashtag","pages":[{"title":"Lookup Country by ISO Code","openapi":"GET /iso/country","href":"/api/endpoints/lookup-country-by-iso"},{"title":"Lookup State by ISO Code","openapi":"GET /iso/state","href":"/api/endpoints/lookup-state-by-iso"},{"title":"Convert ISO Code","openapi":"GET /iso/country/convert","href":"/api/endpoints/convert-iso-code"}]},{"group":"Search","icon":"magnifying-glass","pages":[{"title":"Fuzzy Search","openapi":"GET /search/fuzzy","href":"/api/endpoints/fuzzy-search"},{"title":"Autocomplete","openapi":"GET /search/autocomplete","href":"/api/endpoints/get-search-autocomplete"},{"title":"Nearby Search","openapi":"GET /search/nearby","description":"Find countries, states, and cities near a coordinate, ranked by straight-line distance","href":"/api/endpoints/get-search-nearby"}]},{"group":"Data Changes","icon":"code-compare","pages":[{"title":"Data Change Feed","openapi":"GET /changes","href":"/api/endpoints/get-data-changes"}]},{"group":"GraphQL API","icon":"diagram-project","pages":[{"title":"GraphQL API","api":"POST https://api.countrystatecity.in/v1/graphql","description":"Query countries, states, cities, regions, and subregions with GraphQL instead of REST","href":"/api/graphql"}]},{"group":"Meta","icon":"circle-info","pages":[{"title":"Get Data Version","openapi":"GET /meta/data-version","href":"/api/endpoints/get-data-version"}]}]},{"tab":"Tools","pages":[{"title":"Tools","href":"/tools/overview"}]},{"tab":"Database","pages":[{"title":"Database","href":"/database/overview"}]}]},"basePath":"","title":"Data Change Feed - Country State City Documentation","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-CVKwuln2.js","dist-CXMB3QQU.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","CodeSnippet-B373COAT.js","getApiPlaygroundDisplay-CfL-UuDS.js","Page-DuqezyvM.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js","Markdown-Dy9a8hT8.js","AssistantPageLink-87tSPwGm.js"]}