Catalog and pricing

List available countries

Parameters

Request example Try it in the Dashboard

curl -X GET "https://papaproxy.net/account_new/api/v1/billing/countries"

import requests

resp = requests.get(
    "https://papaproxy.net/account_new/api/v1/billing/countries",
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/billing/countries", {
  method: "GET",
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/billing/countries');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://papaproxy.net/account_new/api/v1/billing/countries", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Countries you can order. · 7 fields

  Example response · JSONCopy

  {
    "geo_source": "maxmind",
    "product_kind": "proxy_datacenter",
    "countries": [
      {
        "code": "US",
        "name": "United States",
        "tag_id": 197148,
        "available": 32452
      },
      {
        "code": "RU",
        "name": "Russia",
        "tag_id": 197146,
        "available": 15616
      }
    ]
  }

  Field	Type	Description
  geo_source required	string	Geo source the country list is scoped to (maxmind/ripe)
  product_kind required	string	Product kind the availability counts are computed for
  countries	array of object	Available countries, most stock first
  countries[].code required	string	ISO 3166-1 alpha-2 code (e.g. 'DE', 'GB')
  countries[].name required	string	Country name (e.g. 'Germany')
  countries[].tag_id required	integer	Numeric country ID (the ISO code is accepted everywhere this ID is).
  countries[].available required	integer	IPs currently available in this country

• 422 Validation error: a field is missing or has the wrong type or value.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

Get pricing terms

Request example Try it in the Dashboard

curl -X GET "https://papaproxy.net/account_new/api/v1/billing/composite/pricing-info"

import requests

resp = requests.get(
    "https://papaproxy.net/account_new/api/v1/billing/composite/pricing-info",
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/billing/composite/pricing-info", {
  method: "GET",
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/billing/composite/pricing-info');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://papaproxy.net/account_new/api/v1/billing/composite/pricing-info", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Pricing terms for display: volume-discount tiers, term discounts, order minimums, included concurrent connections, and add-on prices. · 22 fields

  Example response · JSONCopy

  {
    "volume_tiers": [
      {
        "min_ips": 0,
        "price_millicents_per_ip": 19000,
        "label": null
      },
      {
        "min_ips": 100,
        "price_millicents_per_ip": 19000,
        "label": null
      }
    ],
    "period_discounts": {},
    "min_ips_per_segment": 10,
    "min_ips_per_order": 100,
    "conn_cap_tiers": [
      {
        "min_ips": 0,
        "max_ips": 800,
        "flat_cap": 1500,
        "multiplier": null
      },
      {
        "min_ips": 800,
        "max_ips": 5000,
        "flat_cap": null,
        "multiplier": 3
      }
    ],
    "whitelist_free_quota": 5,
    "extra_whitelist_ip_price_cents": 100,
    "free_refresh_days": 8,
    "trial": {
      "enabled": true,
      "period_days": 2,
      "tariff_coefficient": 2.0,
      "registration_window_enabled": false,
      "registration_window_days": 30,
      "max_per_month": 3
    }
  }

  Field	Type	Description
  volume_tiers required	array of object	Volume-discount tiers, ascending by min_ips.
  volume_tiers[].min_ips required	integer	Total-IP threshold at which this tier appliesMinimum: 0
  volume_tiers[].price_millicents_per_ip required	integer	Per-IP price in millicents (1/1000 of a cent)Minimum: 0
  volume_tiers[].label	string, nullable	Human-readable tier label.
  period_discounts required	object	Period-months (string key) -> whole-percentage discount
  min_ips_per_segment required	integer	Minimum IP count for a single segment to be acceptedMinimum: 1
  min_ips_per_order required	integer	Minimum total IP count (summed across segments) for an orderMinimum: 1
  conn_cap_tiers	array of object	Included concurrent connections by IP count.
  conn_cap_tiers[].min_ips required	integer	Inclusive lower bound of this bucket's IP rangeMinimum: 0
  conn_cap_tiers[].max_ips	integer, nullable	Exclusive upper bound; null = no upper bound (last bucket)
  conn_cap_tiers[].flat_cap	integer, nullable	Flat connection cap for this bucket
  conn_cap_tiers[].multiplier	integer, nullable	Per-IP connection multiplier for this bucket
  whitelist_free_quota	integer	Whitelist IPs included free with each service.Default: 0
  extra_whitelist_ip_price_cents	integer	Monthly price per whitelist IP beyond the free allowance, in cents.Default: 0
  free_refresh_days	integer	Interval, in days, between free scheduled IP list refreshes.Default: 0
  trial	object	Paid 48-hour trial settings: availability, length in days, and price coefficient.
  trial.enabled	boolean	Default: true
  trial.period_days	integer	Term length in days.Minimum: 1Default: 2
  trial.tariff_coefficient	number	Default: 2
  trial.registration_window_enabled	boolean	Default: false
  trial.registration_window_days	integer	Minimum: 1Default: 30
  trial.max_per_month	integer	Minimum: 0Default: 3

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

Distribute IPs across countries

Request body

Request example Try it in the Dashboard

curl -X POST "https://papaproxy.net/account_new/api/v1/billing/composite/auto-plan" \
  -H "Content-Type: application/json" \
  -d '{"total_ip": 300}'

import requests

resp = requests.post(
    "https://papaproxy.net/account_new/api/v1/billing/composite/auto-plan",
    json={
        "total_ip": 300
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/billing/composite/auto-plan", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "total_ip": 300
  }),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/billing/composite/auto-plan');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'total_ip' => 300
    ]),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

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

func main() {
	req, err := http.NewRequest("POST", "https://papaproxy.net/account_new/api/v1/billing/composite/auto-plan", strings.NewReader(`{"total_ip": 300}`))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Proposed distribution of IPs by country. · 8 fields

  Example response · JSONCopy

  {
    "snapshot_version": "5c7f1a22-bcbf-5cf5-845f-92443fc4d544",
    "segments": [
      {
        "country": 197148,
        "country_code": "US",
        "count": 148
      },
      {
        "country": 197146,
        "country_code": "RU",
        "count": 71
      }
    ],
    "total_ip": 300,
    "countries_used": 4,
    "subnet_diversity": null
  }

  Field	Type	Description
  snapshot_version required	string (uuid)	Version of the availability data used for this response.
  segments	array of object	Proposed per-country distribution, summing to total_ip
  segments[].country required	integer	Numeric country ID. The ISO code is in country_code.
  segments[].country_code	string, nullable	ISO 3166-1 alpha-2 country code (e.g. "DE").
  segments[].count required	integer	Number of IPs allocated to this countryMinimum: 1
  total_ip required	integer	Total IP count across all segments (echoes the request)
  countries_used required	integer	Number of distinct countries in the plan
  subnet_diversity	integer, nullable	Number of distinct /24 subnets in the proposed allocation. Available for ISP proxies only; null for other products.

• 422 Validation error, or total_ip is below 100.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

Get a price quote

Request body

Request example Try it in the Dashboard

curl -X POST "https://papaproxy.net/account_new/api/v1/billing/composite/quote" \
  -H "Content-Type: application/json" \
  -d '{"segments": [{"country": "US", "count": 100}], "period_months": 1}'

import requests

resp = requests.post(
    "https://papaproxy.net/account_new/api/v1/billing/composite/quote",
    json={
        "segments": [
            {
                "country": "US",
                "count": 100
            }
        ],
        "period_months": 1
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/billing/composite/quote", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "segments": [
      {
        "country": "US",
        "count": 100
      }
    ],
    "period_months": 1
  }),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/billing/composite/quote');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'segments' => [[
            'country' => 'US',
            'count' => 100
        ]],
        'period_months' => 1
    ]),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

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

func main() {
	req, err := http.NewRequest("POST", "https://papaproxy.net/account_new/api/v1/billing/composite/quote", strings.NewReader(`{"segments": [{"country": "US", "count": 100}], "period_months": 1}`))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Price quote. Check errors for segments that were left out. · 42 fields

  Example response · JSONCopy

  {
    "snapshot_version": "5c7f1a22-bcbf-5cf5-845f-92443fc4d544",
    "built_at": "2026-10-30T04:00:18.702558Z",
    "binding": false,
    "segments": [
      {
        "country": 197148,
        "country_code": "US",
        "count": 100,
        "unit_base_cents": 19,
        "type_multiplier": 1.0,
        "geo_multiplier": 1.0,
        "segment_price_cents": 1900,
        "available": true
      }
    ],
    "errors": [],
    "total_ip": 100,
    "total_price_cents": 1900,
    "unit_base_cents": 19,
    "period_months": 1,
    "discount_pct": 0,
    "volume_discount_pct": 0,
    "monthly_price_cents": 1900,
    "retail_total_price_cents": null,
    "retail_monthly_price_cents": null,
    "partner_discount_percent": null,
    "partner_discount_cents": null,
    "promo_code_applied": null,
    "promo_discount_cents": 0,
    "total_before_promo_cents": null,
    "trial": false,
    "trial_period_days": null,
    "trial_coefficient": null,
    "addon_monthly_cents": 0,
    "addon_breakdown": [],
    "trial_price_cents": null,
    "extra_whitelist_count": 0,
    "extra_connections_count": 0,
    "udp_unlock": false
  }

  Field	Type	Description
  snapshot_version required	string (uuid)	Version of the availability data used for this quote.
  built_at	string (date-time), nullable	When the availability data was last updated (UTC).
  binding	boolean	Always false — quotation is non-bindingDefault: false
  segments	array of object	Per-segment pricing breakdown
  segments[].country required	integer	Numeric country ID. The ISO code is in country_code.
  segments[].country_code	string, nullable	ISO 3166-1 alpha-2 country code (e.g. "DE").
  segments[].count required	integer
  segments[].unit_base_cents required	integer	Volume-tier base unit price in integer cents per IP
  segments[].type_multiplier required	number	Product multiplier applied to the base rate.
  segments[].geo_multiplier required	number	Country multiplier (default 1.0).
  segments[].segment_price_cents required	integer	Segment price: count × base rate × product multiplier × country multiplier, rounded up to whole cents.
  segments[].available required	boolean	Whether enough IPs are available for this segment.
  errors	array of object	Errors for unavailable/invalid segments
  errors[].country required	integer	Numeric country ID of the segment that was left out.
  errors[].message required	string
  total_ip	integer	Total IP count across all valid segmentsDefault: 0
  total_price_cents	integer	Discounted total charged for the full period in integer cents. Equals monthly_price_cents x period_months x (1 - discount).Default: 0
  unit_base_cents	integer	Volume-tier base unit price applied (cents per IP)Default: 0
  period_months	integer	Billing period length in months (1/3/6/12)Default: 1
  discount_pct	integer	Term discount as a whole percentage. The volume discount is reported in volume_discount_pct.Default: 0
  volume_discount_pct	integer	Volume discount as a whole percentage, for display. Term discount is reported separately in discount_pct; both are already included in total_price_cents.Default: 0
  monthly_price_cents	integer	Undiscounted monthly total (sum of segment prices) in integer centsDefault: 0
  retail_total_price_cents	integer, nullable	Total before the partner discount, in cents. Null unless a partner discount applies.
  retail_monthly_price_cents	integer, nullable	Monthly price before the partner discount, in cents. Null unless a partner discount applies.
  partner_discount_percent	integer, nullable	Partner discount percentage, when it applies.
  partner_discount_cents	integer, nullable	Partner discount amount in cents, when it applies.
  promo_code_applied	string, nullable	Promo code applied to this quote, if any.
  promo_discount_cents	integer	Absolute promo discount in integer cents applied to total_price_cents.Minimum: 0Default: 0
  total_before_promo_cents	integer, nullable	Pre-promo total in integer cents when a promo was applied; null when no promo.
  trial	boolean	True when the quote is for the paid trial.Default: false
  trial_period_days	integer, nullable	Trial length in days; null for regular quotes.
  trial_coefficient	number, nullable	Price coefficient of the trial; null for regular quotes.
  addon_monthly_cents	integer	Monthly cents from pre-purchase add-ons (whitelist + UDP + connections).Minimum: 0Default: 0
  addon_breakdown	array of object	Per-addon monthly line-items. Sum of monthly_cents equals addon_monthly_cents.
  addon_breakdown[].addon_type required	string	Add-on type.One of: extra_whitelist_ip, udp_unlock, extra_connections
  addon_breakdown[].quantity required	integer	Number of units (IPs or connections; 1 for UDP).Minimum: 0
  addon_breakdown[].unit_price_cents required	integer	Per-unit monthly centsMinimum: 0
  addon_breakdown[].monthly_cents required	integer	Monthly cost: quantity × unit price (UDP is a percentage of the base price).Minimum: 0
  trial_price_cents	integer, nullable	Trial price in cents (before promo); null for regular quotes.
  extra_whitelist_count	integer	Paid whitelist slots included in this quote.Minimum: 0Default: 0
  extra_connections_count	integer	Pre-purchase extra concurrent connections included in this quote.Minimum: 0Default: 0
  udp_unlock	boolean	Whether UDP unlock was included in this quote.Default: false

• 422 Validation error, fewer than 100 IPs in total, or an invalid promo code.

  Example · JSONCopy

  {
    "detail": "Invalid promo code."
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

List products

Parameters

Request example Try it in the Dashboard

curl -X GET "https://papaproxy.net/account_new/api/v1/customer/catalog" \
  -H "Authorization: Bearer $PAPAPROXY_API_KEY"

import os

import requests

resp = requests.get(
    "https://papaproxy.net/account_new/api/v1/customer/catalog",
    headers={"Authorization": f"Bearer {os.environ['PAPAPROXY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/customer/catalog", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.PAPAPROXY_API_KEY}`,
  },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/customer/catalog');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('PAPAPROXY_API_KEY'),
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://papaproxy.net/account_new/api/v1/customer/catalog", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("PAPAPROXY_API_KEY"))
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Paginated product list. · 27 fields

  Example response · JSONCopy

  {
    "products": [
      {
        "id": "5234db61-2f19-5aa0-8e64-faa72f7d4b76",
        "kind": "proxy_rotating",
        "billing_model": "metered_requests",
        "name": "Starter 2.5M",
        "description": "2.5 million requests over 30 days, about 83,000 a day. New datacenter IPv4 from a 100,000+ pool on every request; sticky sessions keep one IP when you need it. Unlimited bandwidth.",
        "params": {
          "ip_count": null,
          "geo": null,
          "protocol": null,
          "rate_limit_rps": null,
          "sticky": true,
          "data_limit_bytes": null,
          "traffic_gb": null,
          "pool_class": "datacenter",
          "devices": null,
          "period_days": 30,
          "request_package_size": 2500000
        },
        "price_cents": 4900,
        "price_unit": "period",
        "price_book_id": "1f4229e5-ac7e-50ae-bc7c-2680e501a91f",
        "is_active": true,
        "features": []
      },
      {
        "id": "79001ddf-8570-583a-9045-0511848550e4",
        "kind": "proxy_rotating",
        "billing_model": "metered_requests",
        "name": "Standard 5M",
        "description": "5 million requests over 30 days, about 167,000 a day. New datacenter IPv4 from a 100,000+ pool on every request; sticky sessions keep one IP when you need it. Unlimited bandwidth.",
        "params": {
          "ip_count": null,
          "geo": null,
          "protocol": null,
          "rate_limit_rps": null,
          "sticky": true,
          "data_limit_bytes": null,
          "traffic_gb": null,
          "pool_class": "datacenter",
          "devices": null,
          "period_days": 30,
          "request_package_size": 5000000
        },
        "price_cents": 7900,
        "price_unit": "period",
        "price_book_id": "1f4229e5-ac7e-50ae-bc7c-2680e501a91f",
        "is_active": true,
        "features": []
      }
    ],
    "total": 6,
    "offset": 0,
    "limit": 2,
    "price_book_kind": "retail"
  }

  Field	Type	Description
  products required	array of object
  products[].id required	string (uuid)	Unique ID.
  products[].kind required	string	Product type, for example proxy_rotating.
  products[].billing_model required	string
  products[].name required	string
  products[].description required	string, nullable
  products[].params required	object, nullable	Product parameters; they vary by product type (for example IP count, locations, term, request allowance, or session settings).
  products[].params.ip_count	integer, nullable	Number of IPs.
  products[].params.geo	array of string, nullable
  products[].params.protocol	string, nullable
  products[].params.rate_limit_rps	integer, nullable
  products[].params.sticky	boolean, nullable
  products[].params.data_limit_bytes	integer, nullable	Data allowance in bytes, for products with a data allowance.
  products[].params.traffic_gb	number, nullable	Data allowance in GB, for products with a data allowance.
  products[].params.pool_class	string, nullable	IP pool type of the product.One of: datacenter, isp
  products[].params.devices	integer, nullable
  products[].params.period_days	integer, nullable	Term length in days.
  products[].params.request_package_size	integer, nullable	Prepaid request count for rotating proxies (for example 2,500,000).
  products[].price_cents	integer, nullable	Resolved retail price in cents; null if none
  products[].price_unit	string, nullable
  products[].price_book_id	string (uuid), nullable	ID of the price list the price comes from.
  products[].is_active required	boolean	Whether it's active.
  products[].features	array of string	Product features.
  total required	integer	Total number of items across all pages.
  offset	integer	Number of items skipped.Default: 0
  limit	integer	Page size.Default: 50
  price_book_kind	string	One of: retail, wholesaleDefault: "retail"

• 401 The API key is missing, malformed, revoked, or expired, or the account is inactive.

  Example · JSONCopy

  {
    "detail": "Invalid or revoked API key."
  }

  Error format

• 403 The API key lacks scope catalog:read.

  Example · JSONCopy

  {
    "detail": "API key is missing required scope: catalog:read"
  }

  Error format

• 422 Validation error: a field is missing or has the wrong type or value.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

Get a product

Parameters

Request example Try it in the Dashboard

curl -X GET "https://papaproxy.net/account_new/api/v1/customer/catalog/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $PAPAPROXY_API_KEY"

import os

import requests

resp = requests.get(
    "https://papaproxy.net/account_new/api/v1/customer/catalog/3fa85f64-5717-4562-b3fc-2c963f66afa6",
    headers={"Authorization": f"Bearer {os.environ['PAPAPROXY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/customer/catalog/3fa85f64-5717-4562-b3fc-2c963f66afa6", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.PAPAPROXY_API_KEY}`,
  },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/customer/catalog/3fa85f64-5717-4562-b3fc-2c963f66afa6');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('PAPAPROXY_API_KEY'),
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://papaproxy.net/account_new/api/v1/customer/catalog/3fa85f64-5717-4562-b3fc-2c963f66afa6", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("PAPAPROXY_API_KEY"))
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 A catalog product. · 22 fields

  Example response · JSONCopy

  {
    "id": "5234db61-2f19-5aa0-8e64-faa72f7d4b76",
    "kind": "proxy_rotating",
    "billing_model": "metered_requests",
    "name": "Starter 2.5M",
    "description": "2.5 million requests over 30 days, about 83,000 a day. New datacenter IPv4 from a 100,000+ pool on every request; sticky sessions keep one IP when you need it. Unlimited bandwidth.",
    "params": {
      "ip_count": null,
      "geo": null,
      "protocol": null,
      "rate_limit_rps": null,
      "sticky": true,
      "data_limit_bytes": null,
      "traffic_gb": null,
      "pool_class": "datacenter",
      "devices": null,
      "period_days": 30,
      "request_package_size": 2500000
    },
    "price_cents": 4900,
    "price_unit": "period",
    "price_book_id": "1f4229e5-ac7e-50ae-bc7c-2680e501a91f",
    "is_active": true,
    "features": []
  }

  Field	Type	Description
  id required	string (uuid)	Unique ID.
  kind required	string	Product type, for example proxy_rotating.
  billing_model required	string
  name required	string
  description required	string, nullable
  params required	object, nullable	Product parameters; they vary by product type (for example IP count, locations, term, request allowance, or session settings).
  params.ip_count	integer, nullable	Number of IPs.
  params.geo	array of string, nullable
  params.protocol	string, nullable
  params.rate_limit_rps	integer, nullable
  params.sticky	boolean, nullable
  params.data_limit_bytes	integer, nullable	Data allowance in bytes, for products with a data allowance.
  params.traffic_gb	number, nullable	Data allowance in GB, for products with a data allowance.
  params.pool_class	string, nullable	IP pool type of the product.One of: datacenter, isp
  params.devices	integer, nullable
  params.period_days	integer, nullable	Term length in days.
  params.request_package_size	integer, nullable	Prepaid request count for rotating proxies (for example 2,500,000).
  price_cents	integer, nullable	Resolved retail price in cents; null if none
  price_unit	string, nullable
  price_book_id	string (uuid), nullable	ID of the price list the price comes from.
  is_active required	boolean	Whether it's active.
  features	array of string	Product features.

• 401 The API key is missing, malformed, revoked, or expired, or the account is inactive.

  Example · JSONCopy

  {
    "detail": "Invalid or revoked API key."
  }

  Error format

• 403 The API key lacks scope catalog:read.

  Example · JSONCopy

  {
    "detail": "API key is missing required scope: catalog:read"
  }

  Error format

• 404 Product not found, or it doesn't belong to your account. — error format
• 422 Validation error: a field is missing or has the wrong type or value.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format