Developers

System

Notes

Returns SkipDNS-wide policy values used by integrations and the cPanel plugin, including free-slot lifetime rules, destination click windows, and one-time link extension options (price labels and duration). Values match server configuration; use this endpoint instead of hardcoding lifetime tiers or extension prices in your UI.

Free-slot previews created by a third party who is not the site owner (such as a hosting provider or agency) must be given to the end customer (for example, in the migration ticket). Free-slot links offered for commercial use are intended as an acquisition channel for paying customers. Links used only internally must be created as paid-slot links on a paid plan, regardless of traffic.

Within a rolling 30-day window per destination (hostname and origin IP), free-slot lifetime follows recent preview clicks:

  • Up to 100 clicks: 1 week
  • Above 100 clicks: 1 day
  • Above 1,000 clicks: 1 hour
  • Above 10,000 clicks: 1 minute

When a free-slot preview expires, you can renew it for free. Paid-slot links can be deleted to free a slot.

Paid-slot links use your plan slots and may include an optional custom expiration.

Show

API endpoint:

GET https://skipdns.link/api/v2/system

Request example:

curl --location --request GET 'https://skipdns.link/api/v2/system' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_token}'

Response body (JSON):

Top-level fields returned on 200 OK. This endpoint has no request body or query parameters.

Field Type Description
free_slot_hours
integer
Default free-slot lifetime in hours when destination clicks are at or below the first ladder threshold (create or free renewal after expiry). Renewal starts from the current moment.
free_slot_destination_clicks_days
integer
Rolling window in days used to count preview clicks per destination (hostname and origin IP).
free_slot_destination_ladder
array
Ordered later tiers. Each item has clicks_above (exclusive lower bound on clicks already recorded in the window) and duration_hours (lifetime for the next create or free renewal).
link_extensions
array
One-time extension checkout options in display order. Each item has price (USD), duration (label), and days (added to the link expiry). Array index matches the extension_index used in checkout URLs.