API key for authentication. Create one in Settings > Developer. The key must have the BITCRM product scope and an orders resource scope; required action depends on the endpoint (READ, WRITE, or DELETE).
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"bitbybit","colors":{"primary":"#ff734c","light":"#fc7b54","dark":"#ff734c"},"logo":{"light":"https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/logo/bbb-logo-default.png?fit=max\u0026auto=format\u0026n=WlT_6AuzhITpdgTf\u0026q=85\u0026s=7690f415d4b16eb95a47bd01fe7c938d","dark":"https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/logo/bbb-logo-light.png?fit=max\u0026auto=format\u0026n=WlT_6AuzhITpdgTf\u0026q=85\u0026s=4aaa8d3bd2de358414b495349a279a6b"},"favicon":{"light":"https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/bbb-icon.png?fit=max\u0026auto=format\u0026n=cHM4z2t-1XWdSut8\u0026q=85\u0026s=7f39b6b551ded4c62302624137f090e3","dark":"https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/bbb-icon.png?fit=max\u0026auto=format\u0026n=cHM4z2t-1XWdSut8\u0026q=85\u0026s=7f39b6b551ded4c62302624137f090e3"},"api":{"openapi":["api-reference/openapi/customers.json","api-reference/openapi/messaging.json","api-reference/openapi/analytics.json","api-reference/openapi/loyalty-bitlogin.json","api-reference/openapi/loyalty-customers.json","api-reference/openapi/shipping.json"]},"navbar":{"primary":{"type":"button","label":"Support","href":"https://api.whatsapp.com/send/?phone=6281514231000\u0026text=Hello+bitbybit+team%2C+I+need+some+assistance"}},"footer":{"socials":{"x":"https://x.com/mintlify","github":"https://github.com/mintlify","linkedin":"https://linkedin.com/company/mintlify"}},"integrations":{"gtm":{"tagId":"GTM-KQ6RZZG"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"asmaraku","hasAudioNarration":false,"actualSubdomain":"asmaraku","customDomains":["knowledge.bitbybit.studio"],"gitSource":{"type":"github","owner":"asmaraku","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aec62a30c9d6432d6b3b0fb","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":122},{"language":"default","tag":"bitCRM","count":100},{"language":"default","tag":"bitChat","count":96},{"language":"default","tag":"AI Studio","count":48},{"language":"default","tag":"bitLink","count":44},{"language":"default","tag":"WhatsApp Commerce","count":44},{"language":"default","tag":"bitApp","count":42},{"language":"default","tag":"Integrations","count":34},{"language":"default","tag":"Settings","count":24},{"language":"default","tag":"Configure","count":21}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":is(#sidebar-content,#mobile-nav):has(a[href=\"/integrations/overview\"],a[href=\"/bitcrm/overview\"],a[href=\"/bitchat/overview\"],a[href=\"/bitapp/overview\"],a[href=\"/bitlink/overview\"],a[href=\"/loyalty/overview\"],a[href=\"/ai-studio/overview\"],a[href=\"/whatsapp-commerce/overview\"],a[href=\"/settings/overview\"],a[href=\"/api-reference/introduction\"]) .sidebar-group-header{display:none}:is(#sidebar-content,#mobile-nav):has(a[href=\"/integrations/overview\"],a[href=\"/bitcrm/overview\"],a[href=\"/bitchat/overview\"],a[href=\"/bitapp/overview\"],a[href=\"/bitlink/overview\"],a[href=\"/loyalty/overview\"],a[href=\"/ai-studio/overview\"],a[href=\"/whatsapp-commerce/overview\"],a[href=\"/settings/overview\"],a[href=\"/api-reference/introduction\"]) li>:is(a,button){padding-block:10px}:is(#sidebar-content,#mobile-nav) li[data-active=\"true\"]>button{font-weight:700}#body-content:has(#sidebar-content a[href=\"/integrations/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitcrm/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitchat/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitapp/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitlink/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/loyalty/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/ai-studio/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/whatsapp-commerce/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/settings/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/api-reference/introduction\"][aria-current=\"page\"]) #header .eyebrow{display:none}#body-content:has(#sidebar-content a[href=\"/integrations/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitcrm/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitchat/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitapp/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/bitlink/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/loyalty/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/ai-studio/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/whatsapp-commerce/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/settings/overview\"][aria-current=\"page\"],#sidebar-content a[href=\"/api-reference/introduction\"][aria-current=\"page\"]) #header .eyebrow+div{margin-block-start:0}"}],"page":{"pagePath":"api-reference/endpoint/shipping/coverage-provinces","slug":"/api-reference/endpoint/shipping/coverage-provinces","pageMetadata":{"title":"List provinces","openapi":"GET /shipping/coverage/provinces","type":"reference","last_verified":"2026-06-30","description":"Return the KiriminAja provinces dictionary. Use the returned `provinceId` to fetch cities in the next step.\n\nRequires the merchant to have KiriminAja connected in Settings > Integrations.","href":"/api-reference/endpoint/shipping/coverage-provinces"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Return the KiriminAja provinces dictionary. Use the returned \", _jsx(_components.code, {\n children: \"provinceId\"\n }), \" to fetch cities in the next step.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Requires the merchant to have KiriminAja connected in Settings > Integrations.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List provinces","openapi":"GET /shipping/coverage/provinces","type":"reference","last_verified":"2026-06-30","description":"Return the KiriminAja provinces dictionary. Use the returned `provinceId` to fetch cities in the next step.\n\nRequires the merchant to have KiriminAja connected in Settings > Integrations.","href":"/api-reference/endpoint/shipping/coverage-provinces"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/asmaraku/fc5a36b1d957f891/gtm.js","/_mintlify/custom/asmaraku/1c64b6fee57ecbb2/support-whatsapp.js","/_mintlify/custom/asmaraku/a513d42309b690fd/livechat-widget.js"],"openApiReferenceData":{"operation":{"operationId":"getCoverageProvinces","summary":"List provinces (KiriminAja)","description":"Return the KiriminAja provinces dictionary. Use the returned `provinceId` to fetch cities in the next step.\n\nRequires the merchant to have KiriminAja connected in Settings > Integrations.","tags":["Coverage"],"parameters":["7bb2aef7-fa1a-49a7-a17e-033638dac735"],"responses":{"200":"4848f43d-e4cd-4c9e-ac16-6ba09e06aeb2","400":"95d3527c-b82c-4e72-b5d0-cc996861d35f","401":"9e8ec588-21ae-4427-aa69-9886c965a664"},"method":"get","type":"path","servers":["f87f312f-c6bb-4524-8620-20d9101bfe91"],"security":["7d901f2c-7a10-43d2-80b4-e00571f148c6"],"path":"/shipping/coverage/provinces","baseUrlOptions":["https://api.bitbybit.studio/customer/api/open/v1"],"title":"List provinces (KiriminAja)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7bb2aef7-fa1a-49a7-a17e-033638dac735":{"name":"provider","in":"query","schema":{"type":"string","enum":["kirimin_aja"],"default":"kirimin_aja","description":"Currently only `kirimin_aja` is supported.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Currently only `kirimin_aja` is supported."}},"responses":{"4848f43d-e4cd-4c9e-ac16-6ba09e06aeb2":{"description":"Provinces list.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"provinceId":{"type":"integer","uniqueKey":"data.items.[INDEX].provinceId","typeLabel":"integer"},"provinceName":{"type":"string","uniqueKey":"data.items.[INDEX].provinceName","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":[{"provinceId":11,"provinceName":"ACEH"},{"provinceId":31,"provinceName":"DKI JAKARTA"}]},"examples":{"Example":{"title":"Example","value":{"data":[{"provinceId":11,"provinceName":"ACEH"},{"provinceId":31,"provinceName":"DKI JAKARTA"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"95d3527c-b82c-4e72-b5d0-cc996861d35f":{"description":"The required courier integration is not connected for this company.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable code, e.g. `VALIDATION_ERROR`, `NOT_FOUND`, `INTEGRATION_NOT_CONNECTED`, `PROVIDER_ERROR`, `BOOKING_FAILED`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INTEGRATION_NOT_CONNECTED","message":"KiriminAja is not connected. Connect KiriminAja in Settings > Integrations first."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INTEGRATION_NOT_CONNECTED","message":"KiriminAja is not connected. Connect KiriminAja in Settings > Integrations first."}}}},"exampleType":"examples"}},"exampleType":"examples"},"9e8ec588-21ae-4427-aa69-9886c965a664":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable code, e.g. `VALIDATION_ERROR`, `NOT_FOUND`, `INTEGRATION_NOT_CONNECTED`, `PROVIDER_ERROR`, `BOOKING_FAILED`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"UNAUTHORIZED","message":"Invalid API key"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"Invalid API key"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"7d901f2c-7a10-43d2-80b4-e00571f148c6":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication. Create one in Settings > Developer. The key must have the `BITCRM` product scope and an `orders` resource scope; required action depends on the endpoint (`READ`, `WRITE`, or `DELETE`).","scopes":[]}}},"servers":{"f87f312f-c6bb-4524-8620-20d9101bfe91":{"url":"https://api.bitbybit.studio/customer/api/open/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication. Create one in Settings > Developer. The key must have the `BITCRM` product scope and an `orders` resource scope; required action depends on the endpoint (`READ`, `WRITE`, or `DELETE`).","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key for authentication. Create one in Settings > Developer. The key must have the `BITCRM` product scope and an `orders` resource scope; required action depends on the endpoint (`READ`, `WRITE`, or `DELETE`).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi/shipping.json"},"subdomain":"asmaraku","siteName":"bitbybit","title":"List provinces - bitbybit","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-02T08:23:10.719Z","originalFileLocation":"api-reference/endpoint/shipping/coverage-provinces.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=\"Return the KiriminAja provinces dictionary. Use the returned provinceId to fetch cities in the next step. Requires the merchant to have KiriminAja connected in Settings \u0026gt; Integrations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"bitbybit\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/asmaraku/mcooRqJTgM6wbzpL/_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/asmaraku/mcooRqJTgM6wbzpL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/asmaraku/mcooRqJTgM6wbzpL/_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/asmaraku/mcooRqJTgM6wbzpL/_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/asmaraku/mcooRqJTgM6wbzpL/_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/asmaraku/mcooRqJTgM6wbzpL/_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/asmaraku/mcooRqJTgM6wbzpL/_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/asmaraku/mcooRqJTgM6wbzpL/_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/asmaraku/mcooRqJTgM6wbzpL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List provinces - bitbybit\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return the KiriminAja provinces dictionary. Use the returned provinceId to fetch cities in the next step. Requires the merchant to have KiriminAja connected in Settings \u0026gt; Integrations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"bitbybit\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://asmaraku.mintlify.site/_mintlify/api/og/v2?division=Coverage\u0026amp;title=List+provinces\u0026amp;description=Return+the+KiriminAja+provinces+dictionary.+Use+the+returned+%60provinceId%60+to+fetch+cities+in+the+next+step.%0A%0ARequires+the+merchant+to+have+KiriminAja+connected+\u0026amp;theme=a473618703c526131e2b8363\u0026amp;signature=ccd5311f6d46f8d58e08b4280bc65ed5809ff4eaac4625b88d737e38d2c52276\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List provinces - bitbybit\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return the KiriminAja provinces dictionary. Use the returned provinceId to fetch cities in the next step. Requires the merchant to have KiriminAja connected in Settings \u0026gt; Integrations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://asmaraku.mintlify.site/_mintlify/api/og/v2?division=Coverage\u0026amp;title=List+provinces\u0026amp;description=Return+the+KiriminAja+provinces+dictionary.+Use+the+returned+%60provinceId%60+to+fetch+cities+in+the+next+step.%0A%0ARequires+the+merchant+to+have+KiriminAja+connected+\u0026amp;theme=a473618703c526131e2b8363\u0026amp;signature=ccd5311f6d46f8d58e08b4280bc65ed5809ff4eaac4625b88d737e38d2c52276\">\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/asmaraku/mcooRqJTgM6wbzpL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"bitbybit\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff734c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/shipping/coverage-provinces.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://knowledge.bitbybit.studio/#organization\",\"name\":\"bitbybit\",\"url\":\"https://knowledge.bitbybit.studio\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/logo/bbb-logo-default.png?fit=max\u0026auto=format\u0026n=WlT_6AuzhITpdgTf\u0026q=85\u0026s=7690f415d4b16eb95a47bd01fe7c938d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://knowledge.bitbybit.studio#website\",\"name\":\"bitbybit\",\"url\":\"https://knowledge.bitbybit.studio\",\"publisher\":{\"@id\":\"https://knowledge.bitbybit.studio/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces#webpage\",\"url\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces\",\"name\":\"List provinces\",\"description\":\"Return the KiriminAja provinces dictionary. Use the returned provinceId to fetch cities in the next step. Requires the merchant to have KiriminAja connected in Settings > Integrations.\",\"dateModified\":\"2026-07-02T08:23:10.719Z\",\"isPartOf\":{\"@id\":\"https://knowledge.bitbybit.studio#website\"},\"breadcrumb\":{\"@id\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://knowledge.bitbybit.studio/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Shipping\",\"item\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List provinces\",\"item\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces#apireference\",\"headline\":\"List provinces\",\"name\":\"List provinces\",\"description\":\"Return the KiriminAja provinces dictionary. Use the returned provinceId to fetch cities in the next step. Requires the merchant to have KiriminAja connected in Settings > Integrations.\",\"url\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces\",\"mainEntityOfPage\":{\"@id\":\"https://knowledge.bitbybit.studio/api-reference/endpoint/shipping/coverage-provinces#webpage\"},\"dateModified\":\"2026-07-02T08:23:10.719Z\",\"publisher\":{\"@id\":\"https://knowledge.bitbybit.studio/#organization\"},\"isPartOf\":{\"@id\":\"https://knowledge.bitbybit.studio#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"bitbybit\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"bitbybit","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"bitCRM","pages":[{"title":"bitCRM","href":"/bitcrm/overview"}]},{"tab":"bitChat","pages":[{"title":"bitChat","href":"/bitchat/overview"}]},{"tab":"bitApp","pages":[{"title":"bitApp","href":"/bitapp/overview"}]},{"tab":"bitLink","pages":[{"title":"bitLink","href":"/bitlink/overview"}]},{"tab":"bitLoyalty","pages":[{"title":"bitLoyalty","href":"/loyalty/overview"}]},{"tab":"AI Studio","pages":[{"title":"AI Studio","href":"/ai-studio/overview"}]},{"tab":"WhatsApp Commerce","pages":[{"title":"WhatsApp Commerce","href":"/whatsapp-commerce/overview"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Settings","pages":[{"title":"Settings","href":"/settings/overview"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Introduction","sidebarTitle":"API Reference overview","href":"/api-reference/introduction"},{"group":"Getting Started","icon":"rocket","expanded":false,"pages":[{"title":"Authentication","href":"/api-reference/authentication"},{"title":"IP Whitelisting","href":"/api-reference/ip-whitelisting"},{"title":"Rate Limiting","href":"/api-reference/rate-limiting"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Customers","icon":"users","expanded":false,"pages":[{"title":"List Customers","openapi":"GET /customers","href":"/api-reference/endpoint/customers/list"},{"title":"Get Customer","openapi":"GET /customers/{id}","href":"/api-reference/endpoint/customers/get"},{"title":"Create Customer","openapi":"POST /customers","href":"/api-reference/endpoint/customers/create"},{"title":"Update Customer","openapi":"PUT /customers/{id}","href":"/api-reference/endpoint/customers/update"},{"title":"Delete Customer","openapi":"DELETE /customers/{id}","href":"/api-reference/endpoint/customers/delete"}]},{"group":"Loyalty (bitLogin)","icon":"coins","expanded":false,"pages":[{"title":"Get Loyalty Integration","openapi":"GET /bitlogin/api/open/v1/loyalty/integration","href":"/api-reference/endpoint/loyalty-bitlogin/integration-get"},{"title":"Set Loyalty Integration","openapi":"POST /bitlogin/api/open/v1/loyalty/integration","href":"/api-reference/endpoint/loyalty-bitlogin/integration-set"},{"title":"Get Point Conversion","openapi":"GET /bitlogin/api/open/v1/loyalty/point-conversion","href":"/api-reference/endpoint/loyalty-bitlogin/point-conversion-get"},{"title":"Set Point Conversion","openapi":"POST /bitlogin/api/open/v1/loyalty/point-conversion","href":"/api-reference/endpoint/loyalty-bitlogin/point-conversion-set"},{"title":"List Reward Options","openapi":"GET /bitlogin/api/open/v1/loyalty/reward-options","href":"/api-reference/endpoint/loyalty-bitlogin/reward-options-list"},{"title":"Create Reward Option","openapi":"POST /bitlogin/api/open/v1/loyalty/reward-options","href":"/api-reference/endpoint/loyalty-bitlogin/reward-options-create"},{"title":"Get Reward Option","openapi":"GET /bitlogin/api/open/v1/loyalty/reward-options/{id}","href":"/api-reference/endpoint/loyalty-bitlogin/reward-options-get"},{"title":"Update Reward Option","openapi":"PUT /bitlogin/api/open/v1/loyalty/reward-options/{id}","href":"/api-reference/endpoint/loyalty-bitlogin/reward-options-update"},{"title":"Delete Reward Option","openapi":"DELETE /bitlogin/api/open/v1/loyalty/reward-options/{id}","href":"/api-reference/endpoint/loyalty-bitlogin/reward-options-delete"}]},{"group":"Loyalty (Customer)","icon":"gift","expanded":false,"pages":[{"title":"Loyalty API Overview","href":"/api-reference/endpoint/loyalty-customers/overview"},{"title":"Get Loyalty Reward Options","openapi":"GET /customer/api/open/v1/loyalty/reward-options","href":"/api-reference/endpoint/loyalty-customers/reward-options"},{"title":"Get Loyalty Wallet","openapi":"GET /customer/api/open/v1/loyalty/customers/{customerId}/wallet","href":"/api-reference/endpoint/loyalty-customers/wallet"},{"title":"Adjust Loyalty Points","openapi":"POST /customer/api/open/v1/loyalty/customers/{customerId}/points/adjust","href":"/api-reference/endpoint/loyalty-customers/points-adjust"},{"title":"Redeem Loyalty Reward","openapi":"POST /customer/api/open/v1/loyalty/customers/{customerId}/redeem","href":"/api-reference/endpoint/loyalty-customers/redeem"},{"title":"Get Customer Redemptions","openapi":"GET /customer/api/open/v1/loyalty/customers/{customerId}/redemptions","href":"/api-reference/endpoint/loyalty-customers/redemptions"},{"title":"Get Redeemed Points Summary","openapi":"GET /customer/api/open/v1/loyalty/customers/{customerId}/redemptions/summary","href":"/api-reference/endpoint/loyalty-customers/redeemed-summary"},{"title":"Get Point History","openapi":"GET /customer/api/open/v1/loyalty/customers/{customerId}/history","href":"/api-reference/endpoint/loyalty-customers/point-history"},{"title":"Get Customer Timeline","openapi":"GET /customer/api/open/v1/loyalty/customers/{customerId}/timeline","href":"/api-reference/endpoint/loyalty-customers/timeline"},{"title":"Reward Redemption Summary List","openapi":"GET /customer/api/open/v1/loyalty/rewards/redemptions/summary","href":"/api-reference/endpoint/loyalty-customers/redeem-summary-list"},{"title":"Reward Redemption Summary Detail","openapi":"GET /customer/api/open/v1/loyalty/rewards/{rewardOptionId}/redemptions/summary","href":"/api-reference/endpoint/loyalty-customers/redeem-summary-detail"},{"title":"Reward Redeemers","openapi":"GET /customer/api/open/v1/loyalty/rewards/{rewardOptionId}/redeemers","href":"/api-reference/endpoint/loyalty-customers/redeemers"}]},{"group":"Orders","icon":"receipt","expanded":false,"pages":[{"title":"List Orders","openapi":"GET /orders","href":"/api-reference/endpoint/orders/list"},{"title":"Get Order","openapi":"GET /orders/{id}","href":"/api-reference/endpoint/orders/get"},{"title":"Get Order Shipping","openapi":"GET /orders/{id}/shipping","href":"/api-reference/endpoint/orders/get-shipping"},{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/endpoint/orders/create"},{"title":"Update Order","openapi":"PUT /orders/{id}","href":"/api-reference/endpoint/orders/update"}]},{"group":"Shipping","icon":"truck","expanded":false,"pages":[{"title":"Shipping overview","href":"/api-reference/endpoint/shipping/overview"},{"group":"Store Locations","icon":"location-dot","expanded":false,"pages":[{"title":"List store locations","openapi":"GET /shipping/store-locations","href":"/api-reference/endpoint/shipping/list-store-locations"},{"title":"Get store location","openapi":"GET /shipping/store-locations/{id}","href":"/api-reference/endpoint/shipping/get-store-location"},{"title":"Create store location","openapi":"POST /shipping/store-locations","href":"/api-reference/endpoint/shipping/create-store-location"},{"title":"Update store location","openapi":"PUT /shipping/store-locations/{id}","href":"/api-reference/endpoint/shipping/update-store-location"},{"title":"Delete store location","openapi":"DELETE /shipping/store-locations/{id}","href":"/api-reference/endpoint/shipping/delete-store-location"}]},{"group":"Providers","icon":"truck-fast","expanded":false,"pages":[{"title":"List shipping providers","openapi":"GET /shipping/providers","href":"/api-reference/endpoint/shipping/list-providers"},{"title":"Get provider services","openapi":"GET /shipping/providers/{provider}/services","description":"Return the catalog of services a specific provider offers — for example RideBlitz returns its four `instant_*_hour(s)` tiers, KiriminAja returns the 12 supported couriers plus 3 instant providers, GoSend returns its `Instant` / `SameDay` / `InstantCar` / `SameDayCar` options.\n\nFor KiriminAja the price-time availability is still gated by `POST /shipping/calculate-fee`; this endpoint surfaces the canonical catalog only.","href":"/api-reference/endpoint/shipping/get-provider-services"}]},{"group":"Coverage","icon":"map-location-dot","expanded":false,"pages":[{"title":"List provinces","openapi":"GET /shipping/coverage/provinces","href":"/api-reference/endpoint/shipping/coverage-provinces"},{"title":"List cities","openapi":"GET /shipping/coverage/cities","description":"Return cities for the chosen provider.\n\n- **KiriminAja** (`provider=kirimin_aja`, requires `provinceId`): returns the KA city dictionary for that province with `cityId` you can feed into `/coverage/districts`.\n- **RideBlitz** (`provider=ride_blitz`): returns the 46 hard-coded allowed pickup cities. `provinceId` is ignored. Use one of these values as `options.pickupCity` when calling `/shipping/calculate-fee`.","href":"/api-reference/endpoint/shipping/coverage-cities"},{"title":"List districts","openapi":"GET /shipping/coverage/districts","href":"/api-reference/endpoint/shipping/coverage-districts"},{"title":"List sub-districts","openapi":"GET /shipping/coverage/sub-districts","href":"/api-reference/endpoint/shipping/coverage-sub-districts"}]},{"title":"Calculate shipping fee","openapi":"POST /shipping/calculate-fee","href":"/api-reference/endpoint/shipping/calculate-fee"},{"group":"Shipments","icon":"boxes-stacked","expanded":false,"pages":[{"title":"List shipments","openapi":"GET /shipping/shipments","href":"/api-reference/endpoint/shipping/list-shipments"},{"title":"Get shipment","openapi":"GET /shipping/shipments/{id}","href":"/api-reference/endpoint/shipping/get-shipment"},{"title":"Create shipment","openapi":"POST /shipping/shipments","href":"/api-reference/endpoint/shipping/create-shipment"},{"title":"Update shipment","openapi":"PATCH /shipping/shipments/{id}","href":"/api-reference/endpoint/shipping/update-shipment"},{"title":"Cancel shipment","openapi":"POST /shipping/shipments/{id}/cancel","href":"/api-reference/endpoint/shipping/cancel-shipment"},{"title":"Get shipment tracking","openapi":"GET /shipping/shipments/{id}/tracking","href":"/api-reference/endpoint/shipping/get-shipment-tracking"}]}]},{"group":"Products","icon":"box","expanded":false,"pages":[{"title":"List Products","openapi":"GET /products","href":"/api-reference/endpoint/products/list"},{"title":"Get Product","openapi":"GET /products/{id}","href":"/api-reference/endpoint/products/get"},{"title":"Create Product","openapi":"POST /products","href":"/api-reference/endpoint/products/create"},{"title":"Update Product","openapi":"PUT /products/{id}","href":"/api-reference/endpoint/products/update"},{"title":"Delete Product","openapi":"DELETE /products/{id}","href":"/api-reference/endpoint/products/delete"}]},{"group":"Messaging","icon":"comments","expanded":false,"pages":[{"title":"Send Message","openapi":"POST /messages/send","href":"/api-reference/endpoint/messages/send"},{"title":"Send Template Message","openapi":"POST /messages/send-template","href":"/api-reference/endpoint/messages/send-template"},{"title":"List Request History","openapi":"GET /messages/requests","href":"/api-reference/endpoint/messages/requests"},{"title":"Get Message","openapi":"GET /messages/{messageId}","href":"/api-reference/endpoint/messages/get"}]},{"group":"Analytics","icon":"chart-column","expanded":false,"pages":[{"title":"Overview","href":"/api-reference/endpoint/analytics/overview"},{"title":"Get Agent Analytics","openapi":"GET /analytics/agents","href":"/api-reference/endpoint/analytics/agents"}]},{"group":"Webhooks","icon":"webhook","expanded":false,"pages":[{"title":"Webhooks Overview","href":"/api-reference/webhooks/overview"},{"title":"Webhook Security","href":"/api-reference/webhooks/security"},{"title":"Webhook Events","href":"/api-reference/webhooks/events"},{"title":"Best Practices","href":"/api-reference/webhooks/best-practices"}]}]}]}]},"basePath":"","title":"List provinces - bitbybit","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}