---
title: "Returns residential proxy detection information for the selected IP."
method: GET
path: "/resproxy/{ip}"
tags: ["residential proxy detection"]
---

# Returns residential proxy detection information for the selected IP.

`GET /resproxy/{ip}`

## Request

- Base URL: `https://ipinfo.io`
- URL: `https://ipinfo.io/resproxy/{ip}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
  - API key in query parameter `token`
- TypeScript: <https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/docs/resproxy/:ip/get.ts> (a function with typed inputs; its response is checked against the schema)

The Residential Proxy Detection API provides detailed insights into IP addresses associated with residential, mobile, or datacenter proxy networks.
This includes activity patterns (last seen date, percentage of days active), and proxy service identification.
Services are suffixed with `_mobile` for carrier/mobile proxies or `_datacenter` for datacenter proxies.

## Path parameters

- `ip` string, required

## Response `200`

Residential Proxy detection response.

- ResidentialProxyResponse
  - `ip` string, required: The IPv4 or IPv6 address associated with a residential proxy
  - `last_seen` string, date, required: The last recorded date when the residential proxy IP was active (YYYY-MM-DD, UTC)
  - `percent_days_seen` integer, required: The percentage of days the IP was active in the last 7-day period
  - `service` string, required: The name of the residential proxy service. Suffixed with _mobile for carrier/mobile or _datacenter for datacenter proxies

## Other responses

- `403`: Unknown token or invalid permission. We return the same error for blocking malicious IP addresses as well.
- `404`: Wrong ip. Please provide a valid IP address.
- `429`: Allocated API rate limit has been reached for the token. The user will be prompted with options to increase their API limit.
- `500`: Internal server error or server unavailable.

---

[API](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification.md) - [All operations](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/revisions/c63f11e4f26e?raw)