List Smart List members | Sailor API Docs

const url = 'https://api.sailorhq.io/smart-lists/smartListId/members';
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,
  "members": [
    {
      "id": "00000000-0000-4000-8000-000000000030",
      "contact_id": "00000000-0000-4000-8000-000000000031",
      "phone": "+14165550123",
      "status": "queued",
      "status_reason": null,
      "attempt_count": 0,
      "last_attempted_at": null,
      "last_disposition": null,
      "scheduled_for": null,
      "priority_override": false,
      "added_at": "2026-08-08T00:00:00.000Z",
      "updated_at": "2026-08-08T00:00:00.000Z"
    }
  ],
  "next_page_token": null
}

Returns a stable page of memberships including status, attempts, disposition, and scheduling evidence.

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.

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.

statusenumOptional

Optional exact membership status filter.

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 List memberships.

oktrue

memberslist of objects

next_page_tokenstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

503

Service Unavailable Error