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

# Quick Start

> ISP Pay/GB Proxy Quick Start

<Tip>
  ### Decodo Proxies Use Endpoints

  * Endpoints are like gateways to IP pools.
  * When you connect to an endpoint, your traffic is **automatically** routed through a random IP address from the Decodo IP pool.
</Tip>

* Static Residential proxies use the following endpoint and port for random requests:

```text theme={null}
isp.decodo.com:10000
```

* Here are a few basic request examples in various programming languages:

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -U "USERNAME:PASSWORD" -x "isp.decodo.com:10000" "https://ip.decodo.com/json"
  ```

  ```python Python theme={null}
  import requests
  url = 'https://ip.decodo.com/json'
  username = 'USERNAME'
  password = 'PASSWORD'
  proxy = f"http://{username}:{password}@isp.decodo.com:10000"
  result = requests.get(url, proxies = {
      'http': proxy,
      'https': proxy
  })
  print(result.text)
  ```

  ```javascript Node theme={null}
  const axios = require('axios');
  const { HttpsProxyAgent } = require('https-proxy-agent');

  const url = 'https://ip.decodo.com/json';
  const proxyAgent = new HttpsProxyAgent(
    'http://username:password@isp.decodo.com:10000');

  axios
    .get(url, {
      httpsAgent: proxyAgent,
    })
    .then((response) => {
      console.log(response.data);
    });
  ```

  ```php PHP theme={null}
  <?php

        $url = 'ip.decodo.com/json';
        $proxy = 'isp.decodo.com';
        $port = 10000;
        $user = 'username';
        $psw = 'password';

        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        
        curl_setopt($ch, CURLOPT_PROXY, "$proxy:$port");
        curl_setopt($ch, CURLOPT_PROXYUSERPWD, "$user:$psw");
        $result = curl_exec($ch);
        curl_close($ch);

        if ($result) {
          echo $result . PHP_EOL;
        }
  ```

  ```go Go theme={null}
  package main

  import (
      "log"
      "net/http"
      "net/url"
  )

     func main() {
       proxyUrl, err := url.Parse("http://username:password@isp.decodo.com:10000")
       if err != nil {
         log.Fatalln(err)
       }

       client := &http.Client{
         Transport: &http.Transport{Proxy: http.ProxyURL(proxyUrl)},
       }
       req, err := http.NewRequest("GET", "https://ip.decodo.com/json", nil)
       if err != nil {
         log.Println(err)
       }

       res, err := client.Do(req)
       log.Println(res)

       if err != nil {
         log.Println(err)
       }
     }
  ```

  ```java Java theme={null}
  import java.net.*;
  import java.io.*;
  import java.util.Scanner;

  public class ProxyTest
  {
     public static void main(String[] args) throws Exception
     {
    	InetSocketAddress proxyAddress = new InetSocketAddress("isp.decodo.com", 10000); // Set proxy IP/port.
    	Proxy proxy = new Proxy(Proxy.Type.HTTP, proxyAddress);
    	URL url = new URI("https://ip.decodo.com/").toURL(); //enter target URL
    	Authenticator authenticator = new Authenticator() {
       	public PasswordAuthentication getPasswordAuthentication() {
          	return (new PasswordAuthentication("username","password".toCharArray())); //enter credentials
       	}
    	};

    	Authenticator.setDefault(authenticator);
     URLConnection urlConnection = url.openConnection(proxy);

  //Scanner to view output

  Scanner scanner = new Scanner(urlConnection.getInputStream());
     System.out.println(scanner.nextLine());
     scanner.close();

     }
  }
  ```
</CodeGroup>

<Tip>
  ### Control Your Connection

  * You can make this more specific by adding parameters to control the IP selection and location.
  * Keep reading for a step-by-step walkthrough on specifying and generating more examples, or check out our [**Advanced Parameters**](https://help.decodo.com/docs/isp-pay-per-gb-proxy-advanced-parameters) article for an even more in-depth look.
</Tip>

***

## Authentication

1. First, navigate to the [**Static Residential → ISP Pay/GB → Proxy setup**](https://dashboard.decodo.com/static-isp-proxies/proxy-setup) page on your dashboard and look for the Authentication section.
   * You’ll see that your first proxy user and password are created automatically.
2. Next, select your proxy **authentication method**.
   * This can be either your **whitelisted IP** address or one of your **proxy users**

<img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/bbb5b3363ff96de9f105588c8a26ed4b467ee7d532bf631766857bc74cab3d13-Group_427323227.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=841d48ce066c58657f52c3532f1204c0" alt="" width="3448" height="728" data-path="images/docs/bbb5b3363ff96de9f105588c8a26ed4b467ee7d532bf631766857bc74cab3d13-Group_427323227.png" />

<Tip>
  ### Additional Authentication Options

  1. You may **copy** your password by clicking on it
  2. To see the password, click the **eye** icon.
  3. You can generate a new password by clicking on the **arrow icon** and choosing **Confirm**.
  4. Here, you can also see the **used traffic** and **add a traffic limit** per proxy user, or check the used traffic sum of your whitelisted IPs.

  * You can further manage your credentials in the **Authentication** tab. For more details, check out the [**Authentication Methods**](https://help.decodo.com/docs/isp-pay-per-gb-proxy-authentication-methods) article.
</Tip>

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/846314eaf9f82cdffac52560379455da1941821609b59b9b3d35d25772840941-Group_427323222.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=af9714af173d80aa0a0e1a790d2bc106" style={{ width:"46%" }} className="mx-auto" width="1600" height="380" data-path="images/docs/846314eaf9f82cdffac52560379455da1941821609b59b9b3d35d25772840941-Group_427323222.png" />

## Proxy Setup

In the ISP Pay/GB Proxy Setup section of your dashboard, selecting various parameters will generate examples you can easily copy into your applications, tools, or code.

1. On the [**Static Residential → ISP Pay/GB → Proxy setup**](https://dashboard.decodo.com/static-isp-proxies/proxy-setup) page, find the parameter selection section below your authentication methods.

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/989a17ada26c22b261fdf5318b139fe33c71b5f07f8d87b05e7a63104676f810-Group_427323229.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=e4183675d64529f467ff1fe175295701" alt="" width="3448" height="432" data-path="images/docs/989a17ada26c22b261fdf5318b139fe33c71b5f07f8d87b05e7a63104676f810-Group_427323229.png" />

### Location

2. First, select the [**Location**](https://help.decodo.com/docs/isp-pay-per-gb-proxy-locations) of your proxy.

<Note>
  ### IP-based Whitelisting And Location Selection

  * For ISP Pay/GB Proxies a location can only be specified when using the `user:pass` authentication method. Otherwise, you can only select a `random` location with a whitelisted IP.
</Note>

<img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/b821f70200a106b644d30918f13ff0365a2a7b76a8dba80144e0eb9b51e8d7d7-Group_427323230.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=19ba19084d2838f4432f3498b2234bee" style={{ width:"46%" }} className="mx-auto" width="1600" height="1628" data-path="images/docs/b821f70200a106b644d30918f13ff0365a2a7b76a8dba80144e0eb9b51e8d7d7-Group_427323230.png" />

### Session Type

3. Afterward, select your preferred [**Session Type**](https://help.decodo.com/docs/isp-pay-per-gb-proxy-session-types), **Rotating** or **Static**.

<Note>
  ### Session Ports

  * **Static** – Ports `10001`-`63000` provide a static IP address that remains until you decide to change it or the session ends.
  * **Rotating** – Port `10000` rotates the IP address on every request you make.
</Note>

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/89bde24b1c4c8994fef0b862d7c28c6ad7e567f08ed442940d5cca1474102e95-Group_427323232.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=844373448728246ab0cd0977f51fee03" style={{ width:"46%" }} className="mx-auto" width="1600" height="760" data-path="images/docs/89bde24b1c4c8994fef0b862d7c28c6ad7e567f08ed442940d5cca1474102e95-Group_427323232.png" />

### Protocol

4. Finally, choose the [**Protocol**](https://help.decodo.com/docs/isp-pay-per-gb-proxy-protocols) format. `Endpoint:port`, `HTTP`, `HTTPS`, and `SOCKS5` options are available.

<img src="https://mintcdn.com/decodo/7ZKpc3GV1DKO_XQr/images/docs/11a4f33877d95be99928c6902148e11d7fafcc788079c3630bdc15fa56e8f8b9-Group_427323211.png?fit=max&auto=format&n=7ZKpc3GV1DKO_XQr&q=85&s=7276797d79d62d986ece8017e9acc354" style={{ width:"46%" }} className="mx-auto" width="1600" height="1604" data-path="images/docs/11a4f33877d95be99928c6902148e11d7fafcc788079c3630bdc15fa56e8f8b9-Group_427323211.png" />

## Proxy List Examples

Once you're done setting up in the Proxy Setup section, you will see a **proxy list** of generated endpoints and ports based on your selection.

1. Simply **copy** it to your clipboard, or **download** a `.csv` or `.txt` file of the created proxy list.
2. Alternatively, **copy** single elements of the generated parameters, such as the **Proxy Address**, **Port**, **Username**, and **Password**, or copy the entire example string.

<img src="https://mintcdn.com/decodo/eRLuBYAbadfvmqDE/images/docs/3d01b3e15a84ba4b0f03cb75cb40cc79ea3bb35312b72ecfd1e12c4c3da1faab-Group_427323233.png?fit=max&auto=format&n=eRLuBYAbadfvmqDE&q=85&s=ccb1432e3f28146f0e648cc464df137d" alt="" width="3448" height="1504" data-path="images/docs/3d01b3e15a84ba4b0f03cb75cb40cc79ea3bb35312b72ecfd1e12c4c3da1faab-Group_427323233.png" />

<Tip>
  ### Endpoint List Control

  1. You can set the **number** of generated endpoints.
  2. As well as how many of them you would like to display **per page** (`10`, `25`, `50`, or `100`).
  3. Hide your password by clicking on the **eye** icon. This will not affect the copy & paste function.
  4. Click **Switch view** at the top right under **Layout** to display the entire parameter string.
</Tip>

<img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/eb1c54e804ad28f9f98cfd6df32476045a9b7d61989e18c949525fdf74bad590-Group_427323234.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=3c394c1784e17fa182ca448e01b71ba1" alt="" width="3448" height="2064" data-path="images/docs/eb1c54e804ad28f9f98cfd6df32476045a9b7d61989e18c949525fdf74bad590-Group_427323234.png" />

## Code Examples

It's important to confirm your proxy is operational before using it in your projects. The **code examples** generated based on your previous selection at the bottom of your Proxy Setup dashboard allow you to quickly test whether your proxy is connecting correctly and displaying your new IP address.

1. You can select any of the available languages: `cURL`, `Python`, `NodeJS`, `PHP`, or`GO`.
2. Copy the pre-configured code example by clicking **Copy** in the bottom right corner.
3. Paste and run the code in your environment.
4. The response will show the proxy IP address and location information, confirming your proxy is working properly.

* If you see the proxy's IP address (not your actual IP) in the response, congratulations! Your proxy is successfully configured and ready to use.

<img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/e352a6fb284091c55a0897eeaba1121f78acb4dcc47df73bb76c3a3771b0c7e6-Group_427323236.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=9dc647b9e73bad9f14bc30b780edddfd" alt="" width="3448" height="1252" data-path="images/docs/e352a6fb284091c55a0897eeaba1121f78acb4dcc47df73bb76c3a3771b0c7e6-Group_427323236.png" />

## Integration Guides

Once you generate the endpoints and ports, you can apply them to any application or tool to start using proxies instantly.

<Note>
  ### Decodo Tools

  * Alternatively, you can use a dedicated Decodo tool — the **Decodo Extension** for [**Chrome**](https://help.decodo.com/docs/decodo-chrome-extension#/) and [**Firefox**](https://help.decodo.com/docs/decodo-firefox-extension#/).
</Note>

<Note>
  ### Integration Guides

  * Check out the most popular 3rd party tool guides in the [**Integrations overview**](https://help.decodo.com/docs/proxy-integrations-overview) section.
</Note>

<Note>
  ### GitHub

  * For any **advanced code samples** and **middleware,** please visit our [**GitHub**](https://github.com/decodo/decodo) page.
</Note>

## Statistics

To track ISP Pay/GB proxy usage, navigate to the [**Static Residential → ISP Pay/GB → Usage statistics**](https://dashboard.decodo.com/static-isp-proxies/statistics) section.

1. Here, you can view a **Graph** of **traffic** or **request** usage sorted by: **User**, **Target**, and choose the **time period**.
2. Export **raw** or **table data** in `.CSV`, `.TXT`, or `.JSON` formats.

* All dates are in `UTC`. Traffic history is limited to `180` days maximum.

<img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/fa223eb1552e948c23eb6c72d50d2a0b549e3c18e1dcd53be7a92bf3697454ea-Group_427323613_1.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=cb51866f6edcd2403cac4d6ca5226bf5" alt="" width="3796" height="3360" data-path="images/docs/fa223eb1552e948c23eb6c72d50d2a0b549e3c18e1dcd53be7a92bf3697454ea-Group_427323613_1.png" />

<Note>
  ### Top Targets, Countries, Users, and IPs

  * Below, you can see even more detailed information in dedicated sections:
    * **Top Targets**: No., Target, Traffic, Requests.
    * **Top Countries**: Country, Traffic, Requests.
    * **Top Users**: User, Traffic, Requests.
    * **Top IPs**: No., IP, Traffic, Requests.
</Note>

<Note>
  [**Here**](https://help.decodo.com/docs/isp-pay-per-gb-proxy-statistics) you can find a more comprehensive look at the **ISP Pay/GB Usage statistics** page.
</Note>

## Troubleshooting

If you are experiencing any issues, please refer to our [**troubleshooting**](https://help.decodo.com/docs/proxy-troubleshooting#/) section or contact our support team directly, which is available **24/7**.

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>
