List Smart Lists | Sailor API Docs

const url = 'https://api.sailorhq.io/smart-lists';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "ok": true,
  "smart_lists": [
    {
      "id": "00000000-0000-4000-8000-000000000020",
      "name": "Fresh inbound leads",
      "description": "New demo requests called before every other source.",
      "priority": "highest",
      "max_attempts_per_day": 4,
      "max_attempts_total": 10,
      "min_retry_seconds": 2700,
      "dial_timeout_seconds": 30,
      "next_list_id": null,
      "source": "public_api",
      "created_at": "2026-08-08T00:00:00.000Z",
      "updated_at": "2026-08-08T00:00:00.000Z"
    }
  ],
  "next_page_token": null
}

Returns a stable page of Smart Lists from the credential's one workspace.

Authentication

AuthorizationBearer

Workspace API key created in Sailor Settings > Integrations > API access.

Query parameters

page_sizeintegerOptional1-100Defaults to 50

Maximum resources to return. Defaults to 50 and is capped at 100.

page_tokenstringOptional1-1024 characters

Opaque token returned by the preceding page. Keep all other query parameters unchanged.

Response headers

X-Request-IdstringOptional

Stable request identifier for support and observability.

RateLimit-PolicystringOptional

Versioned structured quota policy. The syntax follows IETF RateLimit draft 11 and may evolve before standardization.

RateLimitstringOptional

Current structured quota state for the authenticated credential.

Response

A page of Smart Lists.

oktrue

smart_listslist of objects

next_page_tokenstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

503

Service Unavailable Error