Check a Proxy - Floppydata Client API

Use this endpoint after building a rotating proxy connection or listing static proxies.

Request

curl --request POST \
  --url "$FLOPPY_BASE_URL/v2/proxy/check" \
  --header "Content-Type: application/json" \
  --header "X-Api-Key: $FLOPPY_API_KEY" \
  --data '{
    "connectionString": "http://USERNAME:PASSWORD@geo.g-w.info:10080"
  }'

Response

{
  "ip": "123.45.67.89",
  "location": {
    "countryCode": "US",
    "country": "United States",
    "state": "California",
    "city": "San Francisco"
  }
}

Where the Connection String Comes From

Rotating proxies: POST /v2/proxy/rotating/connections returns connection.connectionString.
Static proxies: GET /v2/proxy/static returns items[n].connection.connectionString.

Usage Tips

Situation	Tip
You just generated a rotating connection	Paste `connection.connectionString` into `connectionString` to confirm the exit IP.
You are checking static proxies	Paste `items[n].connection.connectionString` from the static proxy list response.
You want account details	Use account endpoints instead. Proxy check validates the proxy exit, not customer account metadata.
The detected location differs from the requested one	Treat the response as the observed proxy exit and rerun with a different location if strict targeting matters.
The request fails	Check that the protocol, username, password, host, and port are all present in the connection string.

Run proxy check in API Reference

Paste a connection string and inspect the live detected IP and location.

Check Balances and Usage Proxy Basics

​Request

​Response

​Where the Connection String Comes From

​Usage Tips

Run proxy check in API Reference

Request

Response

Where the Connection String Comes From

Usage Tips