Get Residential Logs

Gets historical residential logs for the reseller account with pagination and filtering support. Logs are returned in reverse chronological order (newest first). The starting_after parameter enables cursor-based pagination.

GET/resi/logs

Authentication

Basic username/password authentication

Query Parameters

Parameter	Type	Required	Description
limit	number	Optional	Number of logs to return Validation: Must be between 1 and 100 Default: 10
starting_after	string	Optional	For pagination, the ID of the log to start after. Returns logs that come before/older than this log, since logs are displayed in reverse chronological order Validation: Must be a valid log ID
startDate	number	Optional	Filter logs from this timestamp onwards Validation: Must be a valid Unix timestamp
endDate	number	Optional	Filter logs up to this timestamp Validation: Must be a valid Unix timestamp

limit

Optional

Type:number

Description:

Number of logs to return

Validation:

Must be between 1 and 100

Default:10

starting_after

Optional

Type:string

Description:

For pagination, the ID of the log to start after. Returns logs that come before/older than this log, since logs are displayed in reverse chronological order

Validation:

Must be a valid log ID

startDate

Optional

Type:number

Description:

Filter logs from this timestamp onwards

Validation:

Must be a valid Unix timestamp

endDate

Optional

Type:number

Description:

Filter logs up to this timestamp

Validation:

Must be a valid Unix timestamp

Code Example

NodeJS

const axios = require('axios');

const url = "https://api.unknownproxies.com/api/v1/resi/logs";
const headers = {
  "Authorization": "Basic dXNlcjpwYXNz",
  "Content-Type": "application/json"
};

try {
  const response = await axios.get(url, {
    headers
  });
  console.log(response.data);
} catch (error) {
  console.error('Error:', error.response?.data || error.message);
}

Python

import requests
import json

url = "https://api.unknownproxies.com/api/v1/resi/logs"
headers = {
    "Authorization": "Basic dXNlcjpwYXNz",
    "Content-Type": "application/json"
}

response = requests.get(
    url,
    headers=headers
)

print(response.json())

PHP

<?php
$url = "https://api.unknownproxies.com/api/v1/resi/logs";
$headers = [
    "Authorization: Basic dXNlcjpwYXNz",
    "Content-Type: application/json"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Java

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        
        String url = "https://api.unknownproxies.com/api/v1/resi/logs";
        String auth = "Basic dXNlcjpwYXNz";
        
        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", auth)
            .header("Content-Type", "application/json");
        
        HttpRequest request = requestBuilder
            .get(HttpRequest.BodyPublishers.noBody())
            .build();
        
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

C#

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using System.Net.Http.Headers;

public class Program
{
    public static async Task Main()
    {
        using var client = new HttpClient();
        
        var url = "https://api.unknownproxies.com/api/v1/resi/logs";
        
        // Set basic auth
        var authToken = Convert.ToBase64String(Encoding.UTF8.GetBytes("user:pass"));
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", authToken);
        
        
        
        var response = await client.getAsync(url);
        var result = await response.Content.ReadAsStringAsync();
        
        Console.WriteLine(result);
    }
}

cURL

curl -X GET "https://api.unknownproxies.com/api/v1/resi/logs" \
  -H "Authorization: Basic dXNlcjpwYXNz" \
  -H "Content-Type: application/json"

Javascript

const response = await fetch("https://api.unknownproxies.com/api/v1/resi/logs", {
  method: "GET",
  headers: {
    "Authorization": "Basic dXNlcjpwYXNz",
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data);

Go

package main

import (
    "bytes"
    "encoding/base64"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://api.unknownproxies.com/api/v1/resi/logs"
    reqBody := ""

    var body io.Reader
    if reqBody != "" {
        var buf bytes.Buffer
        if err := json.Compact(&buf, []byte(reqBody)); err == nil {
            body = bytes.NewBuffer(buf.Bytes())
        } else {
            body = bytes.NewBuffer([]byte(reqBody))
        }
    }

    req, _ := http.NewRequest("GET", url, body)
    token := base64.StdEncoding.EncodeToString([]byte("user:pass"))
    req.Header.Set("Authorization", "Basic "+token)
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    b, _ := io.ReadAll(resp.Body)
    fmt.Println(string(b))
}

Response Example

{
  "logs": [
    {
      "id": "-OX23aaa3Vmaaar5b-Zi",
      "requestMethod": "GET",
      "requestedUrl": "/api/v1/resi/logs?limit=2&starting_after=-OX0aaaRYc4_aaasHaaa",
      "requestorIp": "127.0.0.1",
      "requestorUsername": "test1",
      "resellerUsername": "test1",
      "responseBody": {
        "hasMore": true,
        "logs": [...]
      },
      "responseStatus": 200,
      "responseTime": 574,
      "timestamp": 1754000027,
      "userAgent": "PostmanRuntime/7.45.0"
    }
  ],
  "hasMore": true,
  "starting_after": "-OX0i1e3JQON_8OlGlbW"
}