> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # List regions > Returns a list of regions (states or provinces) for countries where `has_provinces_or_states` is `true`. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v1/buy/countries/{country_id}/regions openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget paths: /v1/buy/countries/{country_id}/regions: get: tags: - Buy summary: List regions description: >- Returns a list of regions (states or provinces) for countries where `has_provinces_or_states` is `true`. operationId: buy_regions_list parameters: - name: country_id in: path description: The unique ID of the country. required: true style: simple schema: type: integer format: int32 example: 1892 - name: text_enabled_only in: query description: When `true`, returns only regions that offer text-enabled numbers. style: form explode: true schema: type: boolean responses: '200': description: Returns the list of regions. headers: {} content: application/json: schema: allOf: - $ref: '#/components/schemas/RegionListResponse' - example: regions: - id: 13 name: Alabama - id: 15 name: Arizona - id: 16 name: Arkansas - id: 17 name: California examples: success: summary: Successful response value: regions: - id: 13 name: Alabama - id: 15 name: Arizona - id: 16 name: Arkansas - id: 17 name: California '400': $ref: '#/components/responses/BadRequestErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' '404': $ref: '#/components/responses/NotFoundErrorResponse' '422': $ref: '#/components/responses/CountryHasNoRegionsErrorResponse' deprecated: false security: - bearerAuth: - numbers:read components: schemas: RegionListResponse: title: RegionListResponse required: - regions type: object additionalProperties: false properties: regions: type: array description: States or provinces available for the requested country. items: $ref: '#/components/schemas/Region' Region: title: Region required: - id - name type: object additionalProperties: false properties: id: type: integer description: Region ID. format: int32 example: 17 name: type: string description: Region name. example: California description: State or province of the country, if applicable. ValidationErrorResponse: title: ValidationErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description naming the missing or invalid request parameter. example: Missing or invalid parameter ForbiddenErrorResponse: title: ForbiddenErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable description of why access is forbidden. example: The service is not provisioned for your account. NotFoundErrorResponse: title: NotFoundErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description stating that no resource matches the given ID. example: Record not found CountryHasNoRegionsErrorResponse: title: CountryHasNoRegionsErrorResponse type: object properties: success: type: boolean description: Indicates whether the request succeeded. example: false message: type: string description: Human-readable error message. example: Country has no states or provinces responses: BadRequestErrorResponse: description: Request failed. Missing or invalid parameter headers: {} content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' NotFoundErrorResponse: description: Request failed. An object with the specified ID is not found. headers: {} content: application/json: schema: $ref: '#/components/schemas/NotFoundErrorResponse' CountryHasNoRegionsErrorResponse: description: Country has no states or provinces headers: {} content: application/json: schema: $ref: '#/components/schemas/CountryHasNoRegionsErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````