# Getting Started

Make a request to `https://ip.oxylabs.io/location` using a residential proxy from a random location through our [**backconnect entry**](https://developers.oxylabs.io/proxies/residential-proxies/making-requests). Replace `USERNAME` and `PASSWORD` with your proxy user credentials. Keep in mind that each request returns a new IP address as Oxylabs Residential Proxies rotate automatically.

{% hint style="info" %}
Use [**ip.oxylabs.io/location**](https://ip.oxylabs.io/location) to check the parameters of your IPs—this domain delivers information from four geolocation databases: MaxMind, IP2Location, DB-IP, and IPinfo.io. The parameters include IP address, provider, country, city, ZIP code, ASN, organization name, and time zone.
{% endhint %}

```bash
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location
```

{% hint style="info" %}
Our Residential Proxies support `HTTP`, `HTTPS`, and `SOCKS5` protocols. You can learn more about using them [**here**](https://developers.oxylabs.io/proxies/residential-proxies/protocols). 
{% endhint %}

Now make a request using a proxy from France. All you need to do is add `cc-FR` to your username string. Below is an example in cURL, while here you can find [code samples in other languages](https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-country).

```bash
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-FR:PASSWORD" https://ip.oxylabs.io/location
```

Here is another example of a request that goes through a proxy from London, United Kingdom. Adding `cc-GB-city-london` to the username string enables you to specify a city. Click [**here**](https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-city) to get more information on how to master city-level proxy targeting.

```shell
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-GB-city-london:PASSWORD" https://ip.oxylabs.io
```

If you need to keep the same proxy for more than one request, use a [**session control**](https://developers.oxylabs.io/proxies/residential-proxies/session-control)**.** Add `sessid-abc12345` to your username string, where `abc12345` can be any random string, and as long as you keep sending requests with this string (session ID), you will get the same proxy IP. Learn more [**here**](https://developers.oxylabs.io/proxies/residential-proxies/session-control).

```shell
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-sessid-randomString123:PASSWORD" https://ip.oxylabs.io/location
```

Check out our [**integration tutorials**](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations) with the most popular 3rd party tools, such as [**Multilogin**](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations/multilogin), [**ShadowRocket**](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations/shadowrocket), or [**SwitchyOmega**](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations/switchyomega-1).

You can also set up Residential Proxies using the [**Endpoint generator**](https://developers.oxylabs.io/proxies/residential-proxies/endpoint-generator).

Login to the [**dashboard**](https://dashboard.oxylabs.io/en/overview/RP), select Residential Proxies, and click on the Endpoint generator. Choose the parameters and get a list of endpoints to integrate our proxies with tools of your choice.

To find out your usage statistics, generated traffic, request count, and more, please login to the [**dashboard**](https://dashboard.oxylabs.io/en/). You can also add proxy users (sub-users) and track their statistics separately.

If you have any additional questions, please contact your account manager or our support team at [**support@oxylabs.io**](mailto:support@oxylabs.io).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/proxies/residential-proxies/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.