System
Endpoints
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:
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. |