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

# Retrieve Available Geo-locations

> Obtain a list of available geo-locations for Geonode proxy services.




## OpenAPI

````yaml api-reference/ref/available-geo-locations.yaml get /services/RESIDENTIAL-PREMIUM/targeting-options
openapi: 3.0.3
info:
  title: Geonode Available Geo-locations API
  description: >-
    API for retrieving available geographic locations supported by Geonode's
    proxy services.
  version: 1.0.0
servers:
  - url: https://monitor.geonode.com
    description: Geonode Monitoring Service
security: []
paths:
  /services/RESIDENTIAL-PREMIUM/targeting-options:
    get:
      summary: Retrieve Available Geo-locations
      description: |
        Obtain a list of available geo-locations for Geonode proxy services.
      responses:
        '200':
          description: |
            List of available geo-locations retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    code:
                      type: string
                      description: >-
                        The ISO 3166-1 alpha-2 country code, which is a
                        two-letter code representing the country.
                      example: AF
                    name:
                      type: string
                      description: The full name of the country.
                      example: Afghanistan
                    cities:
                      type: object
                      description: Contains details about city-level targeting.
                      properties:
                        prefix:
                          type: string
                          description: A prefix used for city-level targeting.
                          example: '-city-'
                        options:
                          type: array
                          description: A list of available cities in the country.
                          items:
                            type: object
                            properties:
                              code:
                                type: string
                                description: A unique identifier for the city.
                                example: kabul
                              name:
                                type: string
                                description: The full name of the city.
                                example: Kabul
                    states:
                      type: object
                      description: Contains details about state-level targeting.
                      properties:
                        prefix:
                          type: string
                          description: A prefix used for state-level targeting.
                          example: '-state-'
                        options:
                          type: array
                          description: A list of available states in the country.
                          items:
                            type: object
                            properties:
                              code:
                                type: string
                                description: A unique identifier for the state.
                                example: kabul
                              name:
                                type: string
                                description: The full name of the state.
                                example: Kabul
                    asns:
                      type: object
                      description: Contains details about ASN-level targeting.
                      properties:
                        prefix:
                          type: string
                          description: A prefix used for ASN-level targeting.
                          example: '-asn-'
                        options:
                          type: array
                          description: A list of available ASNs in the country.
                          items:
                            type: object
                            properties:
                              code:
                                type: string
                                description: The unique ASN identifier.
                                example: '131284'
                              name:
                                type: string
                                description: The full name and description of the ASN.
                                example: AS131284 Etisalat Afghan
        '400':
          description: Bad request due to invalid parameters.
        '407':
          description: Unauthorized access due to invalid credentials.
        '500':
          description: Internal server error.
      security:
        - basicAuth: []
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````