IP Analysis Report

Our IP Analysis process performs comprehensive validation of user locations based on IP addresses and device information. This guide explains the structure and contents of an IP analysis report.

Report Structure

The verification report is returned as a JSON object containing a location object with the following key sections:

• Location Status: Overall session status based on IP analysis results
• IP Location Data: Geographic information derived from the IP address
• Device Information: Details about the user's device and browser
• Network Analysis: VPN detection and network provider insights
• Location Comparison: Comparative analysis between IP and document locations
• Verification Metadata: Additional verification details and timestamps

Core Response Fields

interface IPAnalysisResponse {
  location: {
    // Verification Status
    status: 'Approved' | 'Declined' | 'In Review' | 'Not Finished';
 
    // Device Information
    device_brand: string;
    device_model: string;
    browser_family: string;
    os_family: string;
    platform: 'mobile' | 'desktop';
 
    // IP Location Data
    ip_country: string;
    ip_country_code: string;
    ip_state: string;
    ip_city: string;
    latitude: number;
    longitude: number;
    ip_address: string;
 
    // Network Information
    isp: string | null;
    organization: string | null;
    is_vpn_or_tor: boolean;
    is_data_center: boolean;
 
    // Time Zone Data
    time_zone: string;
    time_zone_offset: string;
 
    // Location Comparison
    document_location: {
      latitude: number;
      longitude: number;
    };
    ip_location: {
      latitude: number;
      longitude: number;
    };
    distance_from_document_to_ip_km: {
      distance: number;
      direction: string;
    };
 
    // Warnings
    warnings: {
      risk: string;
      additional_data: string | null;
      log_type: 'information' | 'warning' | 'error';
      short_description: string;
      long_description: string;
    }[];
  }
}

Response Fields

IP Analysis Status

• status: The overall status of the location verification (Options: "Approved", "Declined", "In Review", "Not Finished")

Device Information

• device_brand: The brand of the device (e.g., "Apple", "Samsung", "Google")
• device_model: The model of the device (e.g., "iPhone", "Galaxy S21", "Pixel 6")
• browser_family: The family of the browser being used (e.g., "Chrome", "Safari", "Firefox")
• os_family: The operating system of the device (e.g., "iOS", "Android", "Windows")
• platform: The type of device platform (Options: "mobile", "desktop")

IP Location Data

• ip_country: The full name of the country associated with the IP address
• ip_country_code: The ISO country code associated with the IP address
• ip_state: The state or region associated with the IP address
• ip_city: The city associated with the IP address
• latitude: The latitude coordinate of the IP address location
• longitude: The longitude coordinate of the IP address location
• ip_address: The user's IP address

Network Information

• isp: The Internet Service Provider associated with the IP address
• organization: The organization associated with the IP address (if applicable)
• is_vpn_or_tor: Boolean indicating whether the IP address belongs to a VPN or Tor network
• is_data_center: Boolean indicating whether the IP address belongs to a data center

Time Zone Data

• time_zone: The time zone associated with the IP address location
• time_zone_offset: The UTC offset of the time zone

Location Comparison

• document_location: The coordinates from the document address:
  • latitude: The latitude coordinate of the document location
  • longitude: The longitude coordinate of the document location
• ip_location: The coordinates from the IP address:
  • latitude: The latitude coordinate of the IP location
  • longitude: The longitude coordinate of the IP location
• distance_from_document_to_ip_km: The distance and direction between document and IP locations:
  • distance: The distance in kilometers
  • direction: The compass direction (e.g., "NE", "SW")

Verification Details

• warnings: Array of warning objects with detailed information about verification issues

Sample JSON Response

{
  "ip_analysis": {
    "status": "Approved",
    "device_brand": "Apple",
    "device_model": "iPhone",
    "browser_family": "Mobile Safari",
    "os_family": "iOS",
    "platform": "mobile",
    "ip_country": "Spain",
    "ip_country_code": "ES",
    "ip_state": "Barcelona",
    "ip_city": "Barcelona",
    "latitude": 41.4022,
    "longitude": 2.1407,
    "ip_address": "83.50.226.71",
    "isp": null,
    "organization": null,
    "is_vpn_or_tor": false,
    "is_data_center": false,
    "time_zone": "Europe/Madrid",
    "time_zone_offset": "+0100",
    "locations_info": {
        "ip": {
          "location": {"latitude": 40.2206327, "longitude": 1.5770097},
          "distance_from_id_document": 23.4,
          "distance_from_poa_document": 12.3
        },
        "id_document": {
            "location": {"latitude": 41.2706327, "longitude": 1.9770097},
            "distance_from_ip": 23.4,
            "distance_from_poa_document": 18.7,
        },
        "poa_document": {
          "location": {"latitude": 41.2706327, "longitude": 1.9770097},
          "distance_from_ip": 12.3,
          "distance_from_id_document": 18.7
        },
    },
    "warnings": [],
  },
}