> ## 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.

# Perform Bandwidth-Limited Proxy Session

> This API requires authentication using `BasicAuth`. Provide credentials in the format:

- **Username (`--user`)**: `<geonode_username>-session-<randomString>-limit-<limit>`
- **Password (`--user`)**: `<geonode_password>`
- **Proxy (`--proxy`)**: `http://proxy.geonode.io:<port>`
- **Accept Header**: Specifies the response format (`application/json`).




## OpenAPI

````yaml api-reference/ref/session-perform-bandwidth-limited.yaml get /
openapi: 3.0.3
info:
  title: Geonode Proxy Bandwidth Limit API
  description: API for setting bandwidth limits in Geonode's proxy service.
  version: 1.0.0
servers: []
security: []
paths:
  /:
    get:
      summary: Perform Bandwidth-Limited Proxy Session
      description: >
        This API requires authentication using `BasicAuth`. Provide credentials
        in the format:


        - **Username (`--user`)**:
        `<geonode_username>-session-<randomString>-limit-<limit>`

        - **Password (`--user`)**: `<geonode_password>`

        - **Proxy (`--proxy`)**: `http://proxy.geonode.io:<port>`

        - **Accept Header**: Specifies the response format (`application/json`).
      responses:
        '200':
          description: |
            Bandwidth-limited proxy session executed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Indicates the status of the request.
                    example: success
                  country:
                    type: string
                    description: The full name of the country where the IP is located.
                    example: Algeria
                  countryCode:
                    type: string
                    description: The two-letter country code.
                    example: DZ
                  region:
                    type: string
                    description: The region code.
                    example: '22'
                  regionName:
                    type: string
                    description: The full name of the region.
                    example: Sidi Bel Abbès
                  city:
                    type: string
                    description: The name of the city.
                    example: Sidi Bel Abbes
                  zip:
                    type: string
                    description: The postal code associated with the IP.
                    example: '22000'
                  lat:
                    type: number
                    description: The latitude coordinate.
                    example: 34.8934
                  lon:
                    type: number
                    description: The longitude coordinate.
                    example: -0.6526
                  timezone:
                    type: string
                    description: The timezone of the IP location.
                    example: Africa/Algiers
                  isp:
                    type: string
                    description: The name of the Internet Service Provider.
                    example: 4 djaweb de AS fawri
                  org:
                    type: string
                    description: The organization that owns the IP address, if available.
                    example: ''
                  as:
                    type: string
                    description: The Autonomous System (AS) number.
                    example: AS36947 Telecom Algeria
                  query:
                    type: string
                    description: The queried IP address.
                    example: 197.203.245.147
        '403':
          description: Bad request due to invalid parameters.
        '407':
          description: Unauthorized access due to invalid credentials.
        '500':
          description: Internal server error.
      x-codeSamples:
        - lang: bash
          label: Example curl request
          source: |
            curl --request GET \
                 -x "http://proxy.geonode.io:<port>" \
                 --user "<geonode_username>-session-<randomString>-limit-<limit>:<geonode_password>" \
                 --url "http://ip-api.com/json"

````