Skip to main content

Reseller API

Request format:

Send all parameters via Body → form-data. Requests with raw JSON bodies will be rejected/ignored.

Get Statistics​

Path:

https://api.infatica.io/stats

  • Method: GET
  • Summary: Get Statistics
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • The request will return the last invoice date, the total/used/left traffic

Example of success response:

{
  "last_invoice_at": "YYYY-MM-DD HH:mm:ss",
  "traffic_total": 2199023255552,
  "traffic_used": "69802101",
  "traffic_left": 2198953453451
}

Get online statistics​

Path, Residential:

https://api.infatica.io/nodes-info

Path, Mobile:

https://api.infatica.io/mobile-nodes-info

Path, Datacenter:

https://api.infatica.io/dc-nodes-info

  • Method: GET
  • Summary: Get online of available proxies by country
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • The request will return the statistics of available proxies by countries

Example of success response:

{
"AD":20,"AE":1394,"AF":56,"AG":581
}

Get online and unique statistics​

Path:

https://api.infatica.io/online-info

  • Method: POST
  • Summary: Get online and unique statistics
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in body:
    • "country" - optional, two-letter uppercase country code according to ISO 3166-1.If the parameter is not provided, the selection will include all countries.
    • "type" - optional, the node type: if "mobile" is passed, it will show the online status for mobile proxies.
    • "period" - optional, "hour" or "day" – the period for which the data should be retrieved..
    • "interval" - optional, from 1 and above. The interval for which the data is required.

The parameters period and interval only work together. If they are not provided, the selection will default to 1 day.

  • Responses:
    • The request will return the online and unique statistics by countries

The data is updated every hour.

Example of success response:

[
  {
    "AF": {
      "1 day": {
        "online": 1817,
        "unique": 286
      }
    }
  },
  {
    "AL": {
      "1 day": {
        "online": 10148,
        "unique": 928
      }
    }
  }
]

Get a detailed list of all geos​

Returns a detailed list of all geos with ASNs codes.

Path, Residential:

https://api.infatica.io/count-by-geo

Path, Mobile:

https://api.infatica.io/count-by-geo-mob

Path, Datacenter:

https://api.infatica.io/count-by-geo-dc

  • Method: GET
  • Summary: Get a detailed list of all geos with ASNs codes
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • The request returns the detailed list of all geos with ASNs codes for proxies.

Example of success response:

[
  {
    "country": "US",
    "subdivision": "Florida",
    "city": "Hollywood",
    "isp": "AT&T Internet",
    "asn": 7018,
    "zip": "33020",
    "nodes": 158
  },
  {
    "country": "AR",
    "subdivision": "Corrientes",
    "city": "Corrientes",
    "isp": "Corrientes Telecomunicaciones S.a.p.e.m.",
    "asn": 270044,
    "zip": "3400",
    "nodes": 8
  }
]

Get list of all available keys​

Path:

https://api.infatica.io/keys

  • Method: GET
  • Summary: Get list of all available keys for all packages
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • The query will return a list of all available keys for all packages

Example of success response:

{"description":"Keys found","results":["key_1","key_2","key_3","key_4","key_6","key_N"]}

Get subdivision codes​

Path:

https://api.infatica.io/subdivision-codes

  • Method: GET
  • Summary: Get subdivision codes
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • The request will return list of all available subdivision codes

Example of success response:

[
  [
    {
      "subdivision": "'Asir Region",
      "code": 1
    },
    {
      "subdivision": "A'ana",
      "code": 2
    },
    {
      "subdivision": "Aargau",
      "code": 3
    },
    {
      "subdivision": "Abai Region",
      "code": 4
    }
  ]
]

Get ISP codes​

Path:

https://api.infatica.io/isp-codes

  • Method: GET
  • Summary: Get ISP codes
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • The request will return list of all available ISP codes

Example of success response:

[
  [
    {
      "isp": "# 160,North Usman Road, Third Floor",
      "code": 1
    },
    {
      "isp": "# 203, Express tower",
      "code": 2
    },
    {
      "isp": "# 26, Bannerghatta Road, J. P. Nagar, Phase III",
      "code": 3
    },
    {
      "isp": "# 3BEo, Sangkat Beoun Prolit, Khan 7Makara, Phnom Penh.",
      "code": 4
    }
  ]
]

Get ZIP codes​

Path:

https://api.infatica.io/zip-codes

  • Method: POST
  • Summary: Get ZIP codes
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in body:
    • "country" - optional, two-letter uppercase country code according to ISO 3166-1.
  • Responses:
    • The request will return list of all available ZIP codes

Example of success response:

[
  [
    {
      "zip": "730-0851",
      "country": "JP",
      "subdivision": "Hiroshima",
      "city": "Hiroshima"
    },
    {
      "zip": "690-2101",
      "country": "JP",
      "subdivision": "Shimane",
      "city": "Matsue"
    },
    {
      "zip": "750-0011",
      "country": "JP",
      "subdivision": "Yamaguchi",
      "city": "Shimonoseki"
    },
    {
      "zip": "693-0061",
      "country": "JP",
      "subdivision": "Shimane",
      "city": "Izumo"
    }
  ]
]

Get traffic usage of the package​

Path:

https://api.infatica.io/traffic-details

  • Method: POST
  • Summary: Get traffic consumption of the package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in body:
    • "key" - package key, required;
    • "period" - period (daily, weekly, monthly, all), required;
  • Responses:
    • The request will return detailed information on traffic usage for the selected package for the selected period (daily - 24 hours, weekly - 7 days, monthly - 3 months, all - for three periods(daily, weekly, monthly) )

Example of success response (weekly):

{
  "login_name_1": {
    "2024-04-03 03:00:00": 14661077,
    "2024-04-03 04:00:00": 17455068
  },
  "login_name_2": {
    "2024-04-03 03:00:00": 25661077,
    "2024-04-03 04:00:00": 49455068
  },
  "login_name_N": {
    "2024-04-03 03:00:00": 38661077,
    "2024-04-03 04:00:00": 15455068
  }
}

Create new package​

Path:

https://api.infatica.io/package

Package Creation Time and Webhook Notifications:

The package is created in a queue order. Depending on the system load, the creation time of a new package may take from 2 seconds to one minute. There is a webhook available for precise notifications when the package is created.

  • Method: POST
  • Summary: Create new package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in body:
    • "expired_at" - Date and time the package ended. Format: 2021-01-01 23:59:59, no required;
    • "limit_traffic_common" - Common limit of the traffic in bytes, no required;
    • "limit_traffic_monthly" - Monhtly limit of the traffic in bytes no required;
    • "limit_traffic_weekly" - Weekly limit of the traffic in bytes, no required;
    • "limit_traffic_daily" - Daily limit of the traffic in bytes, no required;
  • Responses:
    • "200": description: "Package successfully added to queue"
    • "400": description: "Invalid parameters"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
  "description": "Package successfully added to queue",
  "results": {
    "package_key": "key123",
    "created_at": "2025-09-29T10:56:47Z",
    "expired_at": "2025-10-29T10:56:47Z",
    "is_suspended": false,
    "is_active": false,
    "status": "Pending",
    "proxy_count": 10000,
    "proxy_package_filter": [],
    "traffic_limits": {
      "daily": false,
      "weekly": false,
      "monthly": false,
      "common": false
    },
    "traffic_usage": {
      "daily": 0,
      "weekly": 0,
      "monthly": 0,
      "common": 0
    },
    "lists": []
  }
}

Update package​

Path:

https://api.infatica.io/package/{packagekey}

  • Method: POST
  • Summary: Update package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Parameters in body:
    • "limit_traffic_common" - Common limit of the traffic in bytes, no required;
    • "limit_traffic_monthly" - Monhtly limit of the traffic in bytes, no required;
    • "limit_traffic_weekly" - Weekly limit of the traffic in bytes, no required;
    • "limit_traffic_daily" - Daily limit of the traffic in bytes, no required;
  • Responses:
    • "200": description: "Package successfully updated"
    • "400": description: "Invalid parameters"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
  "description": "Package successfully updated",
  "results": {
    "package_key": "key123",
    "created_at": "2025-09-29T10:56:47Z",
    "expired_at": false,
    "is_suspended": false,
    "is_active": true,
    "status": "Active",
    "proxy_count": 10000,
    "proxy_package_filter": [],
    "traffic_limits": {
      "daily": false,
      "weekly": false,
      "monthly": false,
      "common": 10000000
    },
    "traffic_usage": {
      "daily": 0,
      "weekly": 0,
      "monthly": 0,
      "common": 0
    },
    "lists": []
  }
}

Update proxy list password​

Path:

https://api.infatica.io/package/{packagekey}/pwd-regenerate

  • Method: POST
  • Summary: Update proxy list Password
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Parameters in body:
    • "id" - ID of proxy list, required;
    • "name" - Name of proxy list, required;
  • Responses:
    • "200": description: "Password successfully regenerated"
    • "400": description: "Invalid parameters"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
  "description": "Password successfully regenerated",
  "results": {
    "package_key": "package_key",
    "created_at": "2025-10-16T11:32:21Z",
    "expired_at": false,
    "is_suspended": false,
    "is_active": true,
    "status": "Active",
    "proxy_count": 10000,
    "proxy_package_filter": [],
    "traffic_limits": {
      "daily": false,
      "weekly": false,
      "monthly": false,
      "common": 123466543
    },
    "traffic_usage": {
      "daily": 0,
      "weekly": 0,
      "monthly": 0,
      "common": 0
    },
    "lists": [
      {
        "id": 18759314,
        "name": "proxy-list-name",
        "login": "proxy-list-login",
        "password": "proxy-list-password",
        "network": "",
        "rotation": 3600,
        "rotation_mode": 0,
        "geo": [
          {
            "country": "",
            "region": "",
            "city": "",
            "isp": ""
          }
        ],
        "format": 1
      }
    ]
  }
}

Get package information​

Path:

https://api.infatica.io/package/{packagekey}

  • Method: GET
  • Summary: Get package information
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Responses:
    • "200": description: "Package found"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
  "description": "Package found",
  "results": {
    "package_key": "key123",
    "created_at": "2025-09-29T10:56:47Z",
    "expired_at": false,
    "is_suspended": false,
    "is_active": true,
    "status": "Active",
    "proxy_count": 10000,
    "proxy_package_filter": [],
    "traffic_limits": {
      "daily": false,
      "weekly": false,
      "monthly": false,
      "common": 10000000
    },
    "traffic_usage": {
      "daily": 0,
      "weekly": 0,
      "monthly": 0,
      "common": 0
    },
    "lists": []
  }
}

Get all packages information​

Path:

https://api.infatica.io/packages

  • Method: GET
  • Summary: Get all packages information
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • "200": description: "Packages found"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Packages found",
    "results": [
        {
            "package_key": "key1",
            "created_at": "2025-05-04T10:36:08Z",
            "expired_at": "2026-01-01T23:59:59Z",
            "is_suspended": false,
            "is_active": true,
            "status": "Active",
            "proxy_count": 10000,
            "proxy_package_filter": [],
            "traffic_limits": {
                "daily": false,
                "weekly": false,
                "monthly": false,
                "common": 100000
            },
            "traffic_usage": {
                "daily": 0,
                "weekly": 0,
                "monthly": 0,
                "common": 0
            },
            "lists": [
                {
                    "id": 123,
                    "name": "list-1",
                    "login": "list-1",
                    "password": "123",
                    "network": "",
                    "rotation": 3600,
                    "rotation_mode": 0,
                    "geo": [
                        {
                            "country": "",
                            "region": "",
                            "city": "",
                            "isp": ""
                        }
                    ],
                    "format": 1
                },
                {
                    "id": 456,
                    "name": "list-2",
                    "login": "list-2",
                    "password": "456",
                    "network": "",
                    "rotation": 3600,
                    "rotation_mode": 0,
                    "geo": [
                        {
                            "country": "",
                            "region": "",
                            "city": "",
                            "isp": ""
                        }
                    ],
                    "format": 1
                }               
            ]
        },
        {
            "package_key": "key2",
            "created_at": "2025-09-29T10:56:47Z",
            "expired_at": false,
            "is_suspended": false,
            "is_active": true,
            "status": "Active",
            "proxy_count": 10000,
            "proxy_package_filter": [],
            "traffic_limits": {
                "daily": false,
                "weekly": false,
                "monthly": false,
                "common": 10000000
            },
            "traffic_usage": {
                "daily": 0,
                "weekly": 0,
                "monthly": 0,
                "common": 0
            },
            "lists": []
        }
    ]
}

Get filtered packages information​

Path:

https://api.infatica.io/packages

  • Method: POST
  • Summary: Get filtered packages information
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in body:
    • "packages" - Comma separated string of keys, no required;
  • Responses:
    • "200": description: "Packages found"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Packages found",
    "results": [
        {
            "package_key": "key1",
            "created_at": "2025-05-04T10:36:08Z",
            "expired_at": "2026-01-01T23:59:59Z",
            "is_suspended": false,
            "is_active": true,
            "status": "Active",
            "proxy_count": 10000,
            "proxy_package_filter": [],
            "traffic_limits": {
                "daily": false,
                "weekly": false,
                "monthly": false,
                "common": 100000
            },
            "traffic_usage": {
                "daily": 0,
                "weekly": 0,
                "monthly": 0,
                "common": 0
            },
            "lists": [
                {
                    "id": 123,
                    "name": "list-1",
                    "login": "list-1",
                    "password": "123",
                    "network": "",
                    "rotation": 3600,
                    "rotation_mode": 0,
                    "geo": [
                        {
                            "country": "",
                            "region": "",
                            "city": "",
                            "isp": ""
                        }
                    ],
                    "format": 1
                },
                {
                    "id": 456,
                    "name": "list-2",
                    "login": "list-2",
                    "password": "456",
                    "network": "",
                    "rotation": 3600,
                    "rotation_mode": 0,
                    "geo": [
                        {
                            "country": "",
                            "region": "",
                            "city": "",
                            "isp": ""
                        }
                    ],
                    "format": 1
                }               
            ]
        },
        {
            "package_key": "key2",
            "created_at": "2025-09-29T10:56:47Z",
            "expired_at": false,
            "is_suspended": false,
            "is_active": true,
            "status": "Active",
            "proxy_count": 10000,
            "proxy_package_filter": [],
            "traffic_limits": {
                "daily": false,
                "weekly": false,
                "monthly": false,
                "common": 10000000
            },
            "traffic_usage": {
                "daily": 0,
                "weekly": 0,
                "monthly": 0,
                "common": 0
            },
            "lists": []
        }
    ]
}

Prolongate package​

Path:

https://api.infatica.io/package/{packagekey}/prolongate

  • Method: POST
  • Summary: Prolongate package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Parameters in body: "expired_at" - Date and time the package ended. Format: 2021-01-01 23:59:59, required;
  • Responses:
    • "200": description: "Package prolongated"
    • "422": description: "Error executing request statement"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Package prolongated",
    "results": {
        "package_key": "key123",
        "created_at": "2025-09-29T10:56:47Z",
        "expired_at": "2026-01-01T23:59:59Z",
        "is_suspended": false,
        "is_active": true,
        "status": "Active",
        "proxy_count": 10000,
        "proxy_package_filter": [],
        "traffic_limits": {
            "daily": false,
            "weekly": false,
            "monthly": false,
            "common": 10000000
        },
        "traffic_usage": {
            "daily": 0,
            "weekly": 0,
            "monthly": 0,
            "common": 0
        },
        "lists": []
    }
}

Suspend package​

Path:

https://api.infatica.io/package/{packagekey}/suspend

  • Method: POST
  • Summary: Suspend package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Responses:
    • "200": description: "Package suspended"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Package suspended",
    "results": {
        "package_key": "key123",
        "created_at": "2025-09-29T10:56:47Z",
        "expired_at": "2026-01-01T23:59:59Z",
        "is_suspended": true,
        "is_active": false,
        "status": "Suspended",
        "proxy_count": 10000,
        "proxy_package_filter": [],
        "traffic_limits": {
            "daily": false,
            "weekly": false,
            "monthly": false,
            "common": 10000000
        },
        "traffic_usage": {
            "daily": 0,
            "weekly": 0,
            "monthly": 0,
            "common": 0
        },
        "lists": []
    }
}

Resume package​

Path:

https://api.infatica.io/package/{packagekey}/resume

  • Method: POST
  • Summary: Resume package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Parameters in body (only for DEACTIVATED packages):
    • "expired_at" - Date and time the package ended. Format: 2021-01-01 23:59:59, required;
    • "limit_traffic_common" - Common limit of the traffic in bytes, no required;
    • "limit_traffic_monthly" - Monhtly limit of the traffic in bytes, no required;
    • "limit_traffic_weekly" - Weekly limit of the traffic in bytes, no required;
    • "limit_traffic_daily" - Daily limit of the traffic in bytes, no required;
  • Responses:
    • "200": description: "Package resumed"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Package resumed",
    "results": {
        "package_key": "key123",
        "created_at": "2025-09-29T10:56:47Z",
        "expired_at": "2026-01-01T23:59:59Z",
        "is_suspended": false,
        "is_active": true,
        "status": "Active",
        "proxy_count": 10000,
        "proxy_package_filter": [],
        "traffic_limits": {
            "daily": false,
            "weekly": false,
            "monthly": false,
            "common": 10000000
        },
        "traffic_usage": {
            "daily": 0,
            "weekly": 0,
            "monthly": 0,
            "common": 0
        },
        "lists": []
    }
}

Deactivate package​

Path:

https://api.infatica.io/package/{packagekey}/deactivate

  • Method: POST
  • Summary: Deactivate package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Responses:
    • "200": description: "Package deactivated"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Package deactivated",
    "results": {
        "package_key": "key123",
        "created_at": "2025-09-29T10:56:47Z",
        "expired_at": false,
        "is_suspended": false,
        "is_active": false,
        "status": "Terminated",
        "proxy_count": 10000,
        "proxy_package_filter": [],
        "traffic_limits": {
            "daily": false,
            "weekly": false,
            "monthly": false,
            "common": 10000000
        },
        "traffic_usage": {
            "daily": 0,
            "weekly": 0,
            "monthly": 0,
            "common": 0
        },
        "lists": []
    }
}

Usage for all packages​

Path:

https://api.infatica.io/usage

  • Method: POST/GET
  • Summary: Usage for all packages
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • "200": description: "Traffic data found"
    • "403": description: "Empty or wrong api_key header"

Example of success response:

{
  "description": "Traffic data found",
  "results": [
    {
      "key": "key1",
      "daily": 0,
      "weekly": 0,
      "monthly": 0,
      "common": 0
    },
    {
      "key": "key2",
      "daily": 0,
      "weekly": 0,
      "monthly": 0,
      "common": 2227159
    }
  ]
}

Usage for package​

Path:

https://api.infatica.io/package/{packagekey}/usage

  • Method: GET
  • Summary: Usage for package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey"- Key of the package, required;
  • Responses:
    • "200": description: "Traffic data found"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Traffic data found",
    "results": {
        "key": "key123",
        "daily": 422388854,
        "weekly": 422388854,
        "monthly": 43220591937,
        "common": 844602295032
    }
}

List countries for proxylist​

Path:

https://api.infatica.io/countries

  • Method: POST/GET
  • Summary: List countries for proxylist
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • "200": array of countries
    • "403": description: "Empty or wrong api_key header"

Example of success response:

{
  "AF": "Afghanistan",
  "AX": "Åland Islands",
  "AL": "Albania",
  "DZ": "Algeria",
  "AS": "American Samoa",
  "AD": "Andorra",
  "AO": "Angola",
  "AI": "Anguilla",
  "AG": "Antigua and Barbuda",
  "AR": "Argentina",
  "AM": "Armenia",
  "AW": "Aruba",
  "AU": "Australia",
  "AT": "Austria",
  "AZ": "Azerbaijan",
  "BS": "Bahamas",
  "BH": "Bahrain",
  "BD": "Bangladesh",
  "...": "..."
}

List regions by country for proxylist​

Path:

https://api.infatica.io/regions/{country_iso_code}

  • Method: POST/GET
  • Summary: List regions by country for proxylist
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "country_iso_code" Country ISO code, required;
  • Responses:
    • "200": array of regions
    • "403": description: "Empty or wrong api_key header"

Example of success response:

[
    "Burgenland",
    "Carinthia",
    "Lower Austria",
    "Salzburg",
    "Styria",
    "Tyrol",
    "Upper Austria",
    "Vienna",
    "Vorarlberg",
    "..."
]

List cities by country and region for proxylist​

Path:

https://api.infatica.io/cities/{country_iso_code}/{region_name}

  • Method: POST/GET
  • Summary: List cities by country and region for proxylist
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "country_iso_code" - Country ISO code, required;
    • "region_name" - Name of the region, required;
  • Responses:
    • "200": array of cities
    • "403": description: "Empty or wrong api_key header"

Example of success response:

[
    "Vienna",
    "Simmering",
    "Ottakring",
    "Floridsdorf",
    "..."
]

List ISPs by country, region and city for proxylist​

Path:

https://api.infatica.io/isps/{country_iso_code}/{region_name}/{city_name}

  • Method: POST/GET
  • Summary: List ISPs by country, region and city for proxylist
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "country_iso_code" - Country ISO code, required;
    • "region_name" - Name of the region, required;
    • "city_name" - Name of the city, required;
  • Responses:
    • "200": array of ISPs
    • "403": description: "Empty or wrong api_key header"

Example of success response:

[
    "kabelplus GmbH",
    "..."
]

All DB for geolocations​

Path:

https://api.infatica.io/geo

  • Method: GET
  • Summary: All DB for geolocations
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • "200": JSON-data of database
    • "403": description: "Empty or wrong api_key header"

Example of success response:

[
    {
        "code": "AD",
        "name": "Andorra",
        "regions": [
            {
                "name": "Andorra la Vella",
                "code": 118,
                "cities": [
                    {
                        "name": "Andorra la Vella",
                        "isps": [
                            "Andorra Telecom, S.a.u."
                        ]
                    }
                ]
            }
        ]
    },
    {
        "code": "AE",
        "name": "United Arab Emirates",
        "regions": [
            {
                "name": "Abu Dhabi",
                "code": 10,
                "cities": [
                    {
                        "name": "Abu Dhabi",
                        "isps": [
                            "e& UAE",
                            "DU Telecom"
                        ]
                    }
                ]
            },
            {
                "name": "Sharjah",
                "code": 2668,
                "cities": [
                    {
                        "name": "Sharjah",
                        "isps": [
                            "e& UAE",
                            "DU Telecom"
                        ]
                    }
                ]
            },
            {
                "name": "Dubai",
                "code": 799,
                "cities": [
                    {
                        "name": "Dubai",
                        "isps": [
                            "e& UAE",
                            "DU Telecom"
                        ]
                    }
                ]
            },
            {
                "name": "Ajman",
                "code": 44,
                "cities": [
                    {
                        "name": "Ajman",
                        "isps": [
                            "e& UAE",
                            "DU Telecom"
                        ]
                    }
                ]
            }
        ]
    }
  ]

List formats for proxylist​

Path:

https://api.infatica.io/formats

  • Method: POST/GET
  • Summary: List formats for proxylist
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • "200": array of formats
    • "403": description: "Empty or wrong api_key header"

Example of success response:

{
    "1": "login:password@host:port",
    "2": "host,port,login,password",
    "3": "http://login:password@host:port",
    "4": "socks5://login:password@host:port",
    "5": "login:password:host:port",
    "6": "host:port:login:password",
    "7": "login@password@host@port"
}

Generate proxylist for package​

Please note that proxies become active within 1–2 minutes after creating the proxy list.

Path:

https://api.infatica.io/package/{packagekey}/generate

  • Method: POST

  • Summary: Generate proxylist for package

  • Parameters in header:

    • "api-key" - User-reseller's API key, required;

  • Parameters in path:

    • "packagekey" - Key of the package, required;

  • Parameters in body:

    • "proxy-list-name" - Name for proxy list, required;
    • "proxy-list-login" - Login for proxy list, required;
    • "proxy-list-password" - Password for proxy list, not required and it cannot be empty. If not provided, a password will be generated automatically;
    • "proxy-list-country" - String country ISO code or array of country ISO codes for proxy list, not required;
    • "proxy-list-region" - Name of the region for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-city" - Name of the city for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-isp" - Name of the ISP for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-zip" - ZIP code for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-rotation-period" - Rotation period for the proxy list in seconds, 0 - for each request, -1 - sticky; 3600 - default, not required;
    • "proxy-list-rotation-mode" - Proxy list rotation mode on failure / Values: 0 - instant, 1 - 5 seconds, 2 - no rotation; / 'instant' - is default value, not required;
    • "proxy-list-format" - Format for proxy list output, not required;
    • "proxy-list-network" - IP, subnet, or list separated by comma, not required;

  • Responses:

    • "200": description: "List successfully generated"
    • "400": description: "Empty or wrong api_key header or wrong package key"
    • "422": description: "Error executing request statement"

Example of success response:

{
    "description": "List successfully generated",
    "results": {
        "id": 18619665,
        "name": "example123",
        "login": "example123",
        "password": "2I1tsdOT",
        "network": "",
        "rotation": 3600,
        "rotation_mode": 0,
        "geo": [
            {
                "country": "",
                "region": "",
                "city": "",
                "isp": ""
            }
        ],
        "format": 1
    }
}

Generate nolist api-tool for package​

Path:

https://api.infatica.io/package/{packagekey}/api-tool

  • Method: POST

  • Summary: Generate nolist api-tool for package

  • Parameters in header:

    • "api-key" - User-reseller's API key, required;

  • Parameters in path:

    • "packagekey" - Key of the package, required;

  • Parameters in body:

    • "proxy-list-name" - Name for proxy list, required;
    • "proxy-list-login" - Login for proxy list, required;
    • "proxy-list-password" - Password for proxy list, not required and it cannot be empty. If not provided, a password will be generated automatically;

  • Responses:

    • "200": description: "List successfully generated"
    • "400": description: "Empty or wrong api_key header or wrong package key"
    • "422": description: "Error executing request statement"

Example of success response:

{
    "description": "List successfully generated",
    "results": {
        "id": 18619670,
        "login": "example456",
        "password": "qzmx3O0Z",
        "Same info as HTTPS proxy URL": "http://example456:qzmx3O0Z@pool.infatica.io:10092",
        "Same info as SOCKS5 proxy URL": "socks5://example456:qzmx3O0Z@pool.infatica.io:10092"
    }
}

The nolist option allows you to generate proxy access without creating a fixed proxy list. Instead of receiving a predefined list of proxies, you get login credentials (username and password) that can be used directly in your requests.

Authentication works the same way as with a regular proxy list - you simply use the provided username and password for proxy access.

The key difference is that when generating a nolist, you do not specify a geographic location during creation. By default, it is set to World Mix, meaning all available locations are included. You can then pass the required parameters (such as geo or other options) directly in the proxy username within the request, for example: example456_c_US:qzmx3O0Z@pool.infatica.io:10092.

In this case, the geo parameter (US) and other options are passed directly in the username, allowing you to control proxy behavior per request without generating a new proxy list.

Instructions on how to work with these logins via API: https://infatica.io/documentation/api-tool/

Update proxylist for package​

Path:

https://api.infatica.io/package/{packagekey}/updatelist

  • Method: POST

  • Summary: Update proxylist for package

  • Parameters in header:

    • "api-key" - User-reseller's API key, required;

  • Parameters in path:

    • "packagekey" - Key of the package, required;

  • Parameters in body:

    • "id" - (ID of proxy list), required;
    • "name" - (Name of proxy list), required;
    • "proxy-list-country" - String country ISO code or array of country ISO codes for proxy list, not required;
    • "proxy-list-region" - Name of the region for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-city" - Name of the city for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-isp" - Name of the ISP for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-zip" - ZIP code for proxy list. The parameter will be used only if proxy-list-country set like a string, not an array, not required;
    • "proxy-list-rotation-period" - (Rotation period for proxy list in second / Default 3600), not required;

  • Responses:

    • "200": description: "List successfully updated"
    • "400": description: "Empty or wrong api_key header or wrong package key"
    • "422": description: "Error executing request statement"

Example of success response:

{
    "description": "List successfully updated",
    "results": {
        "package_key": "key123",
        "created_at": "2025-09-29T10:56:47Z",
        "expired_at": "2026-01-01T23:59:59Z",
        "is_suspended": false,
        "is_active": true,
        "status": "Active",
        "proxy_count": 10000,
        "proxy_package_filter": [],
        "traffic_limits": {
            "daily": false,
            "weekly": false,
            "monthly": false,
            "common": 10000000
        },
        "traffic_usage": {
            "daily": 0,
            "weekly": 0,
            "monthly": 0,
            "common": 0
        },
        "lists": [
            {
                "id": 18619665,
                "name": "example123",
                "login": "example123",
                "password": "2I1tsdOT",
                "network": "",
                "rotation": 3600,
                "rotation_mode": 0,
                "geo": [
                    {
                        "country": "US",
                        "region": "",
                        "city": "",
                        "isp": ""
                    }
                ],
                "format": 1
            },
            {
                "id": 18619670,
                "name": "example456",
                "login": "example456",
                "password": "qzmx3O0Z",
                "network": "",
                "rotation": 3600,
                "rotation_mode": 0,
                "geo": [
                    {
                        "country": "",
                        "region": "",
                        "city": "",
                        "isp": ""
                    }
                ],
                "format": 1
            }
        ]
    }
}

All proxylists for the package​

Path:

https://api.infatica.io/package/{packagekey}/lists

  • Method: POST/GET
  • Summary: All proxylists for the package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Responses:
    • "200": description: "Lists found"
    • "403": description: "Empty or wrong api_key header or wrong package key"

Example of success response:

{
    "description": "Lists found",
    "results": [
        {
            "id": 18619665,
            "name": "example123",
            "login": "example123",
            "password": "2I1tsdOT",
            "network": "",
            "rotation": 3600,
            "rotation_mode": 0,
            "geo": [
                {
                    "country": "US",
                    "region": "",
                    "city": "",
                    "isp": ""
                }
            ],
            "format": 1
        },
        {
            "id": 18619670,
            "name": "example456",
            "login": "example456",
            "password": "qzmx3O0Z",
            "network": "",
            "rotation": 3600,
            "rotation_mode": 0,
            "geo": [
                {
                    "country": "",
                    "region": "",
                    "city": "",
                    "isp": ""
                }
            ],
            "format": 1
        }
    ]
}

Show all proxies in proxylist for package​

Path:

https://api.infatica.io/package/{packagekey}/viewlist

  • Method: POST
  • Summary: Show all proxies in proxylist for package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Parameters in body:
    • "id" - ID of proxy list, required;
    • "name" - Name of proxy list, required;
  • Responses:
    • "200": array of proxies in list
    • "403": description: "Empty or wrong api_key header or wrong package key"
    • "422": description: "Error executing request statement"

Example of success response:

[
    "example123:2I1tsdOT@pool.infatica.io:10000",
    "example123:2I1tsdOT@pool.infatica.io:10001",
    "example123:2I1tsdOT@pool.infatica.io:10002",
    "example123:2I1tsdOT@pool.infatica.io:10003",
    "example123:2I1tsdOT@pool.infatica.io:10004",
    "example123:2I1tsdOT@pool.infatica.io:10005",
    "example123:2I1tsdOT@pool.infatica.io:10006",
    "example123:2I1tsdOT@pool.infatica.io:10007",
    "example123:2I1tsdOT@pool.infatica.io:10008",
    "example123:2I1tsdOT@pool.infatica.io:10009",
    "example123:2I1tsdOT@pool.infatica.io:10010",
    "example123:2I1tsdOT@pool.infatica.io:10011",
    "example123:2I1tsdOT@pool.infatica.io:10012",
    "example123:2I1tsdOT@pool.infatica.io:10013",
    "example123:2I1tsdOT@pool.infatica.io:10014",
    "example123:2I1tsdOT@pool.infatica.io:10015",
    "example123:2I1tsdOT@pool.infatica.io:10016",
    "example123:2I1tsdOT@pool.infatica.io:10017"
]

Remove proxylist for package​

Path:

https://api.infatica.io/package/{packagekey}/removelist

  • Method: POST
  • Summary: Remove proxylist for package
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Parameters in path:
    • "packagekey" - Key of the package, required;
  • Parameters in body:
    • "id" - ID of proxy list, required;
    • "name" - Name of proxy list, required;
  • Responses:
    • "200": description: "List successfully removed"
    • "403": description: "Empty or wrong api_key header or wrong package key"
    • "422": description: "Error executing request statement"

Example of success response:

{
    "description": "List successfully removed",
    "results": {
        "package_key": "key123",
        "created_at": "2025-09-29T10:56:47Z",
        "expired_at": "2026-01-01T23:59:59Z",
        "is_suspended": false,
        "is_active": true,
        "status": "Active",
        "proxy_count": 10000,
        "proxy_package_filter": [],
        "traffic_limits": {
            "daily": false,
            "weekly": false,
            "monthly": false,
            "common": 10000000
        },
        "traffic_usage": {
            "daily": 0,
            "weekly": 0,
            "monthly": 0,
            "common": 0
        },
        "lists": []
    }
}

Check Blacklist IP​

Path:

https://api.infatica.io/check-ip-block/ip-address - where ip-address is the IP address you want to check.

Example: https://api.infatica.io/check-ip-block/203.0.113.10

  • Method: GET
  • Summary: Check Blacklist IP
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • If the IP is blocked, it returns: IP is blocked from YYYY-MM-DD HH:mm:ss (UTC)
    • If the IP is not blocked, it returns: IP is not blocked

Example of success response:

"203.0.113.10 is not blocked"

Remove IP from Blacklist​

Path:

https://api.infatica.io/ip-unblock/ip-address - where ip-address is the IP address you want to remove from the blacklist.

Example: https://api.infatica.io/ip-unblock/203.0.113.10

After the IP is removed from the blacklist, it may take up to 1 hour to become active again.

  • Method: GET
  • Summary: Remove IP from Blacklist
  • Parameters in header:
    • "api-key" - User-reseller's API key, required;
  • Responses:
    • If you try to remove an IP that is not blacklisted, it returns: IP is not blocked
    • If the IP was successfully removed from the blacklist, it returns: IP was deleted from block

Example of success response:

"203.0.113.10 was deleted from block"