Skip to content

List available internet service providers

GET
/locations/isps
curl --request GET \
--url 'https://api.proxyrequest.com/api/v1/locations/isps?package_id=550e8400-e29b-41d4-a716-446655440002' \
--header 'Accept-Language: de' \
--header 'Authorization: Bearer <token>'

Returns ISPs that can be targeted by the selected package and location scope. Use country filters to narrow the result.

code
string
country__code
string
limit
integer

Number of results to return per page.

name
string
offset
integer

The initial index from which to return the results.

ordering
string

Which field to use when ordering the results.

package_id
required
string format: uuid

Package whose targeting availability should be returned.

Examples
ExampleResidentialPackage

Residential package

550e8400-e29b-41d4-a716-446655440002
search
string

Case-insensitive partial search across ISP fields: code and name. Separate multiple terms with spaces or commas; every term must match at least one listed field.

Accept-Language
string
default: en

Preferred language for human-readable API errors. Supported languages: en, ru, uk, de, it, fr, es, zh-hans, ja. Regional language tags and quality weights are accepted; unsupported or omitted values use English.

Examples
de

The operation completed successfully.

Media typeapplication/json
object
count
required
integer
next
string format: uri
nullable
previous
string format: uri
nullable
results
required
Array<object>
object
code
required
ISP Code

Unique internal code used to identify this ISP in location vocabulary entries and provider routing rules. comcast att deutsche_telekom

string
<= 255 characters
name
required
ISP Name

Full display name of the Internet Service Provider. Comcast Cable Communications AT&T Services

string
<= 255 characters
Examples
ExampleAvailableISPs

Available ISPs

{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"code": "comcast",
"name": "Comcast Cable"
}
]
}

The request is malformed or violates a business rule.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
key
additional properties
One of:
string
Examples
ExampleValidationError

Validation error

{
"non_field_errors": [
"The request could not be processed."
]
}
Content-Language
string

Language used for human-readable errors.

Authentication credentials are missing, expired, or invalid.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
key
additional properties
One of:
string
Examples
ExampleAuthenticationRequired

Authentication required

{
"detail": "Authentication credentials were not provided."
}
Content-Language
string

Language used for human-readable errors.

The authenticated account cannot perform this operation.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
key
additional properties
One of:
string
Examples
ExamplePermissionDenied

Permission denied

{
"detail": "You do not have permission to perform this action."
}
Content-Language
string

Language used for human-readable errors.