> ## Documentation Index
> Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Regions

> Retrieves a list of regions (states or provinces), optionally filtered by `CountryID` or `RegionID`.



## OpenAPI

````yaml /openapi/lynx.yaml get /v1/regions
openapi: 3.0.1
info:
  title: Nayax Operational Lynx API
  version: v1
servers:
  - url: https://qa-lynx.nayax.com/operational
security:
  - Authorization: []
paths:
  /v1/regions:
    get:
      tags:
        - Lookups
      summary: Get Regions
      description: >-
        Retrieves a list of regions (states or provinces), optionally filtered
        by `CountryID` or `RegionID`.
      operationId: get-regions
      parameters:
        - name: CountryID
          in: query
          description: The unique identifier of the country to filter the regions.
          schema:
            type: integer
            format: int32
        - name: RegionID
          in: query
          description: The unique identifier of the region to filter the results.
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: A list of regions matching the specified criteria.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RegionsDbEntity'
components:
  schemas:
    RegionsDbEntity:
      type: object
      description: >-
        Represents detailed information about a region (state or province),
        including its identifiers and name.
      properties:
        RegionID:
          type: integer
          format: int32
          nullable: true
          description: The unique identifier of the region.
        RegionName:
          type: string
          nullable: true
          description: The name of the region.
        ShortRegion:
          type: string
          nullable: true
          description: The abbreviated name or code for the region.
        CountryID:
          type: integer
          format: int32
          nullable: true
          description: The unique identifier of the country to which the region belongs.
      additionalProperties: false
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: Enter your Bearer token. It's required to authenticate API requests.

````