ipasis

API Docs

Quickstart

Call the authenticated endpoint with your API key.

curl
curl -s "https://api.ipasis.com/v1/lookup?ip=8.8.8.8" -H "X-API-Key: <your_api_key>"

Try It

Examples

JavaScript (fetch)
javascript
fetch('https://api.ipasis.com/v1/lookup?ip=8.8.8.8', {
  headers: { 'X-API-Key': '<your_api_key>' }
}).then(r => r.json()).then(console.log)
Python (requests)
python
import requests

r = requests.get('https://api.ipasis.com/v1/lookup', params={'ip':'8.8.8.8'}, headers={'X-API-Key':'<your_api_key>'})
print(r.json())
Go (net/http)
go
package main

import (
  "fmt"
  "io"
  "net/http"
  "net/url"
)

func main() {
  endpoint := "https://api.ipasis.com/v1/lookup"
  u, _ := url.Parse(endpoint)
  q := u.Query()
  q.Set("ip", "8.8.8.8")
  u.RawQuery = q.Encode()

  req, _ := http.NewRequest("GET", u.String(), nil)
  req.Header.Set("X-API-Key", "<your_api_key>")

  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}
Java (HttpClient)
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
  public static void main(String[] args) throws Exception {
    String url = "https://api.ipasis.com/v1/lookup?ip=8.8.8.8";
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create(url))
        .header("X-API-Key", "<your_api_key>")
        .build();
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

API

GET /v1/lookup?ip=IP returns a JSON record with privacy flags, ASN, company, abuse, and optional details.

  • ip — IPv4/IPv6 address
  • Auth — send X-API-Key: <key> or Authorization: Bearer <key>
  • Errors — consistent JSON with HTTP codes: 400, 401/403, 429

MMDB Snapshot

We provide an ipasis.mmdb snapshot compatible with the included GeoAPI. See README for export and usage.