List your domains

Goal: retrieve the domains available to your account, to get a domain id for use when creating links.
Prerequisites: an API key (see Authentication).

Steps

1. List verified domains

curl -G https://api-sandbox.slimlinkdev.com/api/v1/domains 
  -H "X-API-Key: <API_KEY>" 
  --data-urlencode "status=1"

Expected response:

{
  "data": {
    "items": [
      {
        "id": "06a447a7-5734-48b0-9dab-021576f0e0d1",
        "domainName": "example.com",
        "isDefault": false,
        "isPreferred": true,
        "protocol": "https",
        "status": 1,
        "externalId": null,
        "fallbackUrl": null,
        "nsRecords": null,
        "createdAt": "2026-01-15T10:00:00Z"
      }
    ],
    "total": 1
  },
  "error_code": null,
  "message": "Request successful"
}

2. Page through results

curl -G https://api-sandbox.slimlinkdev.com/api/v1/domains 
  -H "X-API-Key: <API_KEY>" 
  --data-urlencode "page=2" 
  --data-urlencode "itemsPerPage=10"

Verify

Confirm every returned domain has status: 1 if you filtered for verified domains, and that total matches the expected count.

Common failures

Symptom	Cause	Fix
401 Unauthorized	Missing or invalid API key	Confirm you’re sending X-API-Key: <API_KEY>.
Domain still not usable for links	status not 1 (verified) — see Domain statuses	Wait for provisioning (4/5/6) to complete, or fix DNS/SSL issues.