IP Insights
Data Validation & Fraud Prevention

{
  "ipAddress": "192.168.0.1",
  "ipAddressNumber": 3232235521,
  "ipType": "IPv4",
  "ipCidr": "192.168.0.0/24",
  "connectionType": "wired",
  "hostReverse": "1.0.168.192.rev.some-provider.com",
  "riskReport": {
    "score": 350,
    "level": "low",
    "baseAnalysis": ["low-risk-country", "trusted-provider", "no-strong-risk-signals"]
  },
  "geo": {
    "continent": "North America",
    "countryCode": "US",
    "countryName": "United States of America",
    "countryShortName": "United States",
    "city": "San Francisco",
    "currencyCode": "USD",
    "domainExtension": ".com",
    "languages": "en-US, es-US, es",
    "latitude": 37.7749,
    "longitude": -122.4194,
    "postalCode": "94105",
    "phoneIntCode": "1",
    "region": "California",
    "timezone": "America/Los_Angeles"
  },
  "whois": {
    "rir": "ARIN",
    "asn": {
      "asnId": "15169",
      "asName": "GOOGLE",
      "descr": [
        "Google LLC",
        "Mountain View, CA"
      ],
      "email": [
        "asn-email@somedomain.com"
      ]
    },
    "organization": {
      "orgId": "GOOGL",
      "orgName": "Google LLC",
      "orgType": "ISP",
      "descr": [
        "Leading internet provider",
        "Mountain View, CA"
      ],
      "address": [
        "1600 Amphitheatre Parkway"
      ],
      "country": "US",
      "phone": [
        "+1-800-555-1234"
      ],
      "fax": [
        "+1-800-555-5678"
      ],
      "email": [
        "support@some-organization.com"
      ]
    },
    "abuseContact": {
      "contactId": "ABUSE123",
      "contactType": "abuse",
      "name": "Abuse Desk",
      "address": [
        "123 Abuse St, Suite 100"
      ],
      "phone": [
        "+1-800-ABUSE-123"
      ],
      "fax": [
        "+1-800-ABUSE-456"
      ],
      "email": [
        "abuse@some-organization.com"
      ]
    },
    "adminContact": {
      "contactId": "ADMIN123",
      "contactType": "admin",
      "name": "Admin Desk",
      "address": [
        "456 Admin Lane"
      ],
      "phone": [
        "+1-800-ADMIN-123"
      ],
      "fax": [
        "+1-800-ADMIN-456"
      ],
      "email": [
        "admin@some-organization.com"
      ]
    },
    "techContact": {
      "contactId": "TECH123",
      "contactType": "tech",
      "name": "Tech Desk",
      "address": [
        "456 Tech Lane"
      ],
      "phone": [
        "+1-800-TECH-123"
      ],
      "fax": [
        "+1-800-TECH-456"
      ],
      "email": [
        "tech@organization.com"
      ]
    }
  },
  "trustedProvider": {
    "isKnownProvider": true,
    "provider": "ZScaler",
    "providerType": "ZTNE",
    "description": "Zero Trust Network Access for Enterprises"
  },
  "blocklisted": {
    "isBlockListed": false,
    "sources": 0,
    "activeReports": 0,
    "lastDetected": "2022-01-01T12:00:00Z"
  }
}

import { IPInsights } from '@opportify/sdk-nodejs';

const clientIpInsights = new IPInsights({
  version: '1.0',
  apiKey: 'YOUR-API-KEY-HERE'
});

async function analyzeIP() {
  try {
    const response = await clientIpInsights.analyze({
      ip: '8.8.8.8',
      enableAI: true // only available for paid plans.
    });
    console.log('response', response);
  } catch (error: unknown) {
    console.error('error', error);
  }
}

analyzeIP();

use Opportify\Sdk\IpInsights;

$ipInsights = new IpInsights("<YOUR-KEY-HERE>");

$params = [
  "ip" => "3.1.122.82",
  "enableAi" => true
];

$result = $ipInsights->analyze($params);

// Import classes:
import ai.opportify.client.ApiClient;
import ai.opportify.client.ApiException;
import ai.opportify.client.Configuration;
import ai.opportify.client.auth.*;
import ai.opportify.client.model.*;
import ai.opportify.client.api.IpInsightsApi;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    defaultClient.setBasePath("https://api.opportify.ai/insights/v1");

    // Configure API key authorization: opportifyToken
    ApiKeyAuth opportifyToken = (ApiKeyAuth) defaultClient.getAuthentication("opportifyToken");
    opportifyToken.setApiKey("YOUR API KEY");

    IpInsightsApi apiInstance = new IpInsightsApi(defaultClient);
    AnalyzeIpRequest analyzeIpRequest = new AnalyzeIpRequest();
    analyzeIpRequest.ip("8.8.8.8");
    analyzeIpRequest.enableAI(true); // only available for paid plans.
    try {
      AnalyzeIp200Response result = apiInstance.analyzeIp(analyzeIpRequest);
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println("Exception when calling IpInsightsApi#analyzeIP");
      System.err.println("Status code: " + e.getCode());
      System.err.println("Reason: " + e.getResponseBody());
      System.err.println("Response headers: " + e.getResponseHeaders());
      e.printStackTrace();
    }
  }
}

from opportify_sdk import IpInsights

# Initialize the wrapper with your API key
api_key = "<YOUR-API-KEY-HERE>"
ip_insights = IpInsights(api_key)

# Optional: Configure host, version, and debug mode
ip_insights.set_version("v1")

# Define request parameters
params = {
    "ip": "<SOME-IP-HERE>",
    "enableAi": True
}

# Call the API
try:
    result = ip_insights.analyze(params)
    print("Response:", result)
except Exception as e:
    print(f"Error: {e}")