# ProxyInfo<!-- -->

Provides information about a proxy connection that is used for requests.

## Index[](#Index)

### Properties

* [country_code](https://docs.apify.com/sdk/python/reference/class/ProxyInfo.md#country_code)
* [groups](https://docs.apify.com/sdk/python/reference/class/ProxyInfo.md#groups)
* [subdivision_code](https://docs.apify.com/sdk/python/reference/class/ProxyInfo.md#subdivision_code)

## Properties<!-- -->[](#Properties)

### [](#country_code)[](https://github.com/apify/apify-sdk-python/blob/c674a4d42ade9c1a07f33062b6702497cd34b19d//src/apify/_proxy_configuration.py#L72)country_code

country_code: str | None

If set and relevant proxies are available in your Apify account, all proxied requests will use IP addresses that are geolocated to the specified country. For example `GB` for IPs from Great Britain. Note that online services often have their own rules for handling geolocation and thus the country selection is a best attempt at geolocation, rather than a guaranteed hit. This parameter is optional, by default, each proxied request is assigned an IP address from a random country. The country code needs to be a two letter ISO country code. See the [full list of available country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements). This parameter is optional, by default, the proxy uses all available proxy servers from all countries.

### [](#groups)[](https://github.com/apify/apify-sdk-python/blob/c674a4d42ade9c1a07f33062b6702497cd34b19d//src/apify/_proxy_configuration.py#L68)groups

groups: list\[str]

An array of proxy groups to be used by the [Apify Proxy](https://docs.apify.com/proxy). If not provided, the proxy will select the groups automatically.

### [](#subdivision_code)[](https://github.com/apify/apify-sdk-python/blob/c674a4d42ade9c1a07f33062b6702497cd34b19d//src/apify/_proxy_configuration.py#L82)subdivision_code

subdivision_code: str | None

If set, the proxy will use IP addresses geolocated to the specified subdivision (e.g. US state). Requires `country_code` to be set. The subdivision code must be a 1-3 character ISO 3166-2 code consisting of uppercase letters and digits (e.g. `CA` for California). Currently only supported for the United States (`country_code='US'`).
