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 '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
string format: uuid

Package whose targeting availability should be returned. Required when package-based authentication is enabled.

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.

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>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExampleValidationError

Validation error

{
"non_field_errors": [
"The request could not be processed."
],
"translation": "errors.request.invalid"
}

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>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExampleAuthenticationRequired

Authentication required

{
"detail": "Authentication credentials were not provided."
}

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>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExamplePermissionDenied

Permission denied

{
"detail": "You do not have permission to perform this action."
}