> ## Documentation Index > Fetch the complete documentation index at: https://docs.spurtcommerce.com/llms.txt > Use this file to discover all available pages before exploring further. # List delivery zones, optionally filtered by country. > List delivery zones, optionally filtered by country. **Authentication:** Public; tenant validation applies. **Feature area:** Store content **Implementation source:** `src/api/store/controllers/CommonListController.ts` **Request example provenance:** Source-defined response field names; sample record is illustrative. **Response example provenance:** Source-defined response field names; sample record is illustrative. > **Example status: Illustrative.** The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract. ## OpenAPI ````yaml /StoreAPI.json get /api/store-list/zone openapi: 3.0.3 info: title: SpurtCommerce Store API version: 6.0.0 description: >- Store API reference generated from the public SpurtCommerce repository (master, package version 6.0.0). Route inventory, controller annotations, request examples and response examples were used where available. Examples that are not explicitly defined by source annotations are marked illustrative in the operation description. This specification excludes Admin APIs. license: name: MIT url: https://github.com/spurtcommerce/spurtcommerce/blob/master/LICENSE servers: - url: https://api.example.com description: Replace with your SpurtCommerce API host. Paths include the /api prefix. security: [] tags: - name: Store description: Store API endpoint reference, organized by functional topic. - name: Cart description: >- Retrieve, create, update, and clear the authenticated customer shopping cart. x-parent: Store x-displayName: Cart - name: Customer address description: >- Create, retrieve, and manage customer addresses and live-address settings used during checkout. x-parent: Store x-displayName: Customer address - name: Customer profile description: >- Retrieve and update the signed-in customer profile and read customer permission modules and assignments. x-parent: Store x-displayName: Customer profile - name: Authentication description: >- Register customers, send and verify OTPs, sign in, sign out, and authenticate through supported OAuth providers. x-parent: Store x-displayName: Authentication - name: Wishlist description: >- Add products to the customer wishlist, list saved items, and remove wishlist entries. x-parent: Store x-displayName: Wishlist - name: Product discovery description: >- Discover products and categories, retrieve product details, compare products, and inspect filters, attributes, and variants. x-parent: Store x-displayName: Product discovery - name: Orders description: >- Retrieve order details and payment status, request cancellations, track shipments, download invoices, and retry payments. x-parent: Store x-displayName: Orders - name: Store content description: >- Retrieve storefront settings, categories, languages, zones, payment methods, CMS pages, banners, widgets, and contact information. x-parent: Store x-displayName: Store content - name: Payments description: >- Start supported Store payment flows for existing orders through PayPal, Razorpay, and Stripe. x-parent: Store x-displayName: Payments - name: Ratings and reviews description: >- Retrieve product rating counts, rating distributions, and customer reviews for product SKUs. x-parent: Store x-displayName: Ratings and reviews - name: Products x-parent: Product discovery description: Browse product listings and retrieve product details. - name: Categories x-parent: Product discovery description: Browse storefront product categories and category filters. - name: Product comparison x-parent: Product discovery description: Compare products and retrieve related product suggestions. - name: Attributes and variants x-parent: Product discovery description: Retrieve product attributes and variant options. - name: Product ratings and reviews x-parent: Product discovery description: Retrieve product ratings, statistics and customer reviews. - name: Customer login and sessions x-parent: Authentication description: Register, authenticate and sign out customer accounts. - name: OTP and verification x-parent: Authentication description: Send and verify one-time passwords for customer authentication. - name: OAuth authentication x-parent: Authentication description: Authenticate customers through supported OAuth providers. - name: Customer permissions x-parent: Customer profile description: Retrieve customer permission modules and assignments. - name: Address book x-parent: Customer address description: Manage customer delivery and billing addresses. - name: Cart items x-parent: Cart description: Retrieve, create and remove shopping cart items. - name: Order details and tracking x-parent: Orders description: Retrieve order details, tracking and payment status. - name: Order cancellation x-parent: Orders description: Retrieve cancellation reasons and submit cancellation requests. - name: Order payments x-parent: Orders description: Retry order payments and retrieve payment status. - name: Payment gateways x-parent: Payments description: Start Store payment flows for supported payment gateways. - name: Store configuration x-parent: Store content description: Retrieve storefront settings, payment methods and configuration. - name: Navigation and widgets x-parent: Store content description: Retrieve storefront banners, widgets and navigation data. - name: Localization x-parent: Store content description: Retrieve available languages, zones and localization options. - name: Contact and store information x-parent: Store content description: Retrieve store contact information and public store metadata. - name: Store pages x-parent: Store content description: Retrieve published storefront content pages. paths: /api/store-list/zone: get: tags: - Localization summary: List delivery zones, optionally filtered by country. description: >- List delivery zones, optionally filtered by country. **Authentication:** Public; tenant validation applies. **Feature area:** Store content **Implementation source:** `src/api/store/controllers/CommonListController.ts` **Request example provenance:** Source-defined response field names; sample record is illustrative. **Response example provenance:** Source-defined response field names; sample record is illustrative. > **Example status: Illustrative.** The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract. operationId: getApiStoreListZone parameters: - name: limit in: query required: false schema: type: integer example: '20' description: Query parameter limit. - name: offset in: query required: false schema: type: integer example: '0' description: Query parameter offset. - name: countryId in: query required: false schema: type: integer example: '99' description: Query parameter countryId. - name: count in: query required: false schema: type: boolean example: 'false' description: Query parameter count. responses: '200': description: >- Successful response. Source-defined response field names; sample record is illustrative. Example is illustrative and does not guarantee a stable response contract. content: application/json: schema: type: object properties: status: type: string message: type: string data: type: array items: type: object properties: zoneId: type: integer countryId: type: integer code: type: string name: type: string isActive: type: integer additionalProperties: true additionalProperties: true examples: success: summary: Sample success response value: status: '1' message: Successfully get zone list data: - zoneId: 1 countryId: 99 code: TN name: Tamil Nadu isActive: 1 externalDocs: description: Open implementation source in GitHub url: >- https://github.com/spurtcommerce/spurtcommerce/blob/master/src/api/store/controllers/CommonListController.ts x-codeSamples: - lang: HTTP label: HTTP source: > GET /api/store-list/zone?limit=20&offset=0&countryId=99&count=false HTTP/1.1 Host: Accept: application/json - lang: bash label: cURL source: |- curl --request GET \ 'https:///api/store-list/zone?limit=20&offset=0&countryId=99&count=false' \ --header 'Accept: application/json' - lang: JavaScript label: JavaScript (fetch) source: |- const API_BASE_URL = 'https://'; const url = new URL("/api/store-list/zone", API_BASE_URL); const query = { "limit": "20", "offset": "0", "countryId": "99", "count": "false" }; for (const [key, value] of Object.entries(query)) { url.searchParams.set(key, String(value)); } const headers = { "Accept": "application/json" }; const response = await fetch(url, { method: "GET", headers }); const result = await response.json(); console.log(response.status, result); - lang: JavaScript label: Node.js (Axios) source: >- import axios from 'axios'; const API_BASE_URL = 'https://'; const url = `${API_BASE_URL}/api/store-list/zone`; const API_BASE_URL = 'https://'; const url = `${API_BASE_URL}/api/store-list/zone`; const headers = { "Accept": "application/json" }; const params = { "limit": "20", "offset": "0", "countryId": "99", "count": "false" }; const response = await axios.request({ method: "GET", url, headers, params }); console.log(response.status, response.data); - lang: Python label: Python (requests) source: >- import requests url = 'https:///api/store-list/zone' headers = {'Accept': 'application/json'} params = {'limit': '20', 'offset': '0', 'countryId': '99', 'count': 'false'} response = requests.request('GET', url, headers=headers, params=params) print(response.status_code) print(response.json()) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.