Domainsinitial

List domains in the token Space

GET/api/v1/domains

Initial release contract for server-side management of existing domains. Requires deployment of the developer API migration and runtime enablement. Only the operations in this document accept scoped Dashio developer tokens. Registration, renewal, transfer, billing, and customer webhooks are excluded.

Required token scope: domains:read. Scopes are independent.

Run these examples on a trusted server with DASHIO_API_TOKEN configured. DNS write examples also require the persisted DASHIO_IDEMPOTENCY_KEY for that logical operation. Examples send one request with a bounded timeout and do not retry automatically.

Authentication

bearerAuth API authentication guide

Path parameters

None documented.

Query parameters

limitintegerOptional: Minimum: 1. Maximum: 100.
cursorstring (uuid)Optional: Opaque continuation value from pagination.nextCursor; results sort by resource ID.

Header parameters

None documented.

Request body

No content type declared

No request body schema is documented.

Request & response examples

Copy an example in your preferred language.

request.sh

: "${DASHIO_API_TOKEN:?Set DASHIO_API_TOKEN before running this example}"

curl --fail-with-body --silent --show-error --include --connect-timeout 10 --max-time 30 \
  --request GET 'https://dashio.net/api/v1/domains?limit=20' \
  --header "Authorization: Bearer $DASHIO_API_TOKEN"

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

API response example.

{
  "domains": [
    {
      "id": "881bacbd-3c83-4a2a-9a13-535101702ad3",
      "name": "example.com",
      "status": "ACT",
      "createdAt": "2026-10-01T00:00:00Z",
      "expiresAt": "2027-10-01T00:00:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "nextCursor": null
  }
}

Run examples on a trusted server. Configure the environment variables and replace URL or schema placeholders. For a write, reuse its saved idempotency key only when retrying the identical request.