Skip to main content
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;
    }[];
  }
}

​
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": [],
  },
}
For more information about potential warnings during the IP analysis process, check our IP Analysis Warnings guide.