Get a Smart List | Sailor API Docs

const url = 'https://api.sailorhq.io/smart-lists/smartListId';
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_list": {
    "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"
  }
}

Returns one Smart List only when it belongs to the credential's workspace.

Authentication

AuthorizationBearer

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

Path parameters

smartListIdstringRequiredformat: "uuid"

Smart List identifier returned by the create or list operation.

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

Smart List found.

oktrue

smart_listobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

503

Service Unavailable Error