Skip to main content

Managing Your Instance

Everything about a hosted instance is managed through the hosting API and the dashboard. All calls authenticate with your API key.

View status​

Check your instance's current state, usage, and renewal date:

curl https://api.pryscraper.com/v1/hosting/status \
  -H "Authorization: Bearer pry_live_..."

Response:

{
  "plan": "pro",
  "status": "active",
  "pages_used": 41230,
  "pages_limit": 100000,
  "storage_used_gb": 3.2,
  "storage_limit_gb": 10,
  "concurrent_limit": 100,
  "renews_at": "2026-10-01T00:00:00Z"
}

Status values: active, pending_payment, renewing, suspended, cancelled.

Renew​

Renewals are automatic: a new invoice is created before renews_at, and the period extends once the crypto payment confirms. To renew manually or pay early:

curl -X POST https://api.pryscraper.com/v1/hosting/renew \
  -H "Authorization: Bearer pry_live_..." \
  -H "Content-Type: application/json" \
  -d '{"plan": "pro"}'

This returns an invoice — pay it via x402 exactly like the original signup (see Signup).

Upgrade / downgrade​

Change tiers at renewal time by passing a different plan to the renew call. Upgrades applied mid-cycle are prorated. Enterprise changes are handled by your account contact — email [email protected].

Cancel​

Cancel at the end of the current billing period — no lock-in:

curl -X POST https://api.pryscraper.com/v1/hosting/cancel \
  -H "Authorization: Bearer pry_live_..."
  • Your instance stays active until renews_at.
  • After that, the API key stops working and the instance is decommissioned.
  • Export your data before the period ends; storage is deleted after decommissioning.

Suspension​

An instance is suspended when a renewal invoice goes unpaid past its due date:

  • API requests return 402 Payment Required.
  • Data is retained for a grace period (30 days).
  • Pay the outstanding invoice (via renew) to reactivate immediately.

Suspension is not cancellation — nothing is deleted during the grace period.

FAQ​

Can I switch from pay-per-call to hosting? Yes — sign up for a plan and start using your API key; the two lanes are independent.

Do unused pages roll over? No — page quotas reset each billing period.

Is there a contract? No. Month-to-month, cancel anytime. Enterprise SLAs are contractual.