ports

Buy a port (coming soon: not on sale yet)

Allocates one proven port for the SKU and term, charges the project and returns it in state sold. For API-key organisations billed by invoice. A shop account and any catalogue SKU buy through the cart (POST /v1/cart/items, then POST /v1/checkout) and get problem use_cart here; while owned ports are hidden a shop account gets launch_waitlist. Requires an Idempotency-Key header (CONTRACT §1): the same key with the same body within 24 h replays the stored response; a different body returns 409 idempotency_conflict.

post/v1/ports

Request

  • Base URL: https://api.portproof.org
  • URL: https://api.portproof.org/v1/ports
  • Auth: HTTP bearer

Request body

skustring required
term'monthly' | 'weekly' | 'daily' required
quantity1
carrier_idstring
auto_renewboolean

Response

Default Response

idstring required
state'provisioning' | 'available' | 'reserved' | 'sold' | 'leased' | 'migrating' | 'quarantined' | 'retired' required
site_codestring required
countrystring required
operator'owned' | 'partner' required
allowliststring[] required
egress_v4string nullable required
egress_v6_prefixstring nullable required
v4_is_nat64boolean required
ip_sincestring date-time nullable required
rotation_interval_sinteger required
sticky_untilstring date-time nullable required
cooldown_untilstring date-time nullable required
last_rotation_atstring date-time nullable required
telemetry_sincestring date-time nullable required
uptime_30d_pctnumber nullable required
evidence'signed' | 'observed' required
attestation'signed' | 'observed' required
network'own' | 'partner'
rotation_urlstring uri

Changes

No recorded changes to this operation across all 1 revision of this API.