> ## Documentation Index > Fetch the complete documentation index at: https://floppydata.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Locations > Returns supported rotating proxy countries with static country-level cities and state/subdivision lists. Cities are not nested under states. Use the returned city or state strings directly in buildRotatingProxyConnection; state takes precedence over city when both are supplied. ## OpenAPI ````yaml api-reference/openapi.json GET /v2/proxy/rotating/locations openapi: 3.1.0 info: title: Floppydata Client API description: >- Client API v2 for Web Data, proxy products, proxy tools, and account rollups. You can manage your API keys in [API keys](https://app.floppydata.com/api-keys). version: 2.0.0 servers: - url: https://api.floppydata.net description: Production security: - apiKeyHeader: [] tags: - name: Web Data description: Fetch pages and inspect Web Data balance and usage. - name: Proxy description: Proxy tools shared across proxy products. - name: Rotating Proxy description: Rotating proxy subusers, connections, locations, balance, and usage. - name: Static Proxy description: Static proxy inventory for the authenticated account. - name: Account description: Account-level balance and usage rollups across available products. - name: Cloud Browser description: |- Session-first cloud browsers with persistent settings under the hood. Create a session, connect using the returned WebSocket URL, then navigate with Playwright or Puppeteer. Reuse settings.id to restore the same identity and browser state. paths: /v2/proxy/rotating/locations: get: tags: - Rotating Proxy summary: List rotating proxy locations for a proxy type description: >- Returns supported rotating proxy countries with static country-level cities and state/subdivision lists. Cities are not nested under states. Use the returned city or state strings directly in buildRotatingProxyConnection; state takes precedence over city when both are supplied. operationId: listRotatingProxyLocations parameters: - in: query name: type schema: type: string enum: - residential - mobile - datacenter example: residential required: true description: Proxy type to list locations for. responses: '200': description: Available rotating proxy locations. content: application/json: schema: type: object properties: type: type: string enum: - residential - mobile - datacenter description: Proxy type example: residential items: type: array items: type: object properties: name: type: string example: United States countryCode: type: string minLength: 2 maxLength: 2 example: US cities: type: array items: type: string example: - New York - Los Angeles states: type: array items: type: string description: >- Static country-level state/subdivision values to send in POST /v2/proxy/rotating/connections. These are not city-under-state mappings. example: - california - newyork required: - name - countryCode - cities - states description: >- Static country-level city and subdivision lists. When building a connection, state wins over city if both are supplied. required: - type - items example: type: residential items: - name: United States countryCode: US cities: - New York - Los Angeles states: - california - newyork '400': description: The request body or query parameters are invalid. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: invalid_request message: Invalid request parameters. details: issues: - path: country code: invalid_format message: Expected a 2-letter country code. '401': description: The API key is missing, invalid, or expired. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: unauthorized message: Unauthorized details: {} '402': description: The account does not have enough balance for this request. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: insufficient_balance message: Insufficient proxy traffic balance. details: {} '403': description: The API key does not grant access to this operation. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: forbidden message: Forbidden details: {} '404': description: The requested resource is not available. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: not_found message: Rotating proxy credential was not found. details: {} '409': description: The authenticated account is not configured for this product. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: account_not_configured message: Account is not configured for proxy products. details: {} '500': description: An unexpected server error occurred. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: internal_error message: Internal Server Error details: {} '502': description: An upstream service failed while processing the request. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: upstream_error message: Failed to fetch data from an upstream service. details: upstreamStatus: 503 components: securitySchemes: apiKeyHeader: type: apiKey in: header name: X-Api-Key description: Client API key for the authenticated account. ````