diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 2b11449..9800444 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.27.0"
+  ".": "0.28.0"
 }
diff --git a/.stats.yml b/.stats.yml
index e7050ac..8ada60b 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 12
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sequenzy/sequenzy-8a0acc1c46addc277e6a3f99b5cb30988f6a169b52c1c67101ce8d4d2c11806d.yml
-openapi_spec_hash: 010be44d4524b428a4b4e1041b27d00e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sequenzy/sequenzy-7f2b073ea4c3e3cb027f11f0393dee20aa914add0ce247f8163d44cbba203fab.yml
+openapi_spec_hash: 2de87ace4f5f04f4caeb143a6b18a20f
 config_hash: 51c1d1194ac58d8c8e3162839c8f84dd
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f5042cb..998b050 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.28.0 (2026-07-06)
+
+Full Changelog: [v0.27.0...v0.28.0](https://github.com/Sequenzy/sequenzy-typescript/compare/v0.27.0...v0.28.0)
+
+### Features
+
+* **api:** api update ([271d978](https://github.com/Sequenzy/sequenzy-typescript/commit/271d97832d72dbc2adbb09bb4fe7f4ef09d7256d))
+
 ## 0.27.0 (2026-06-29)
 
 Full Changelog: [v0.26.0...v0.27.0](https://github.com/Sequenzy/sequenzy-typescript/compare/v0.26.0...v0.27.0)
diff --git a/package.json b/package.json
index 1d50784..3015283 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "sequenzy",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "The official TypeScript library for the Sequenzy API",
   "author": "Sequenzy <nic@sequenzy.com>",
   "types": "dist/index.d.ts",
diff --git a/src/resources/subscribers/subscribers.ts b/src/resources/subscribers/subscribers.ts
index 37a87f4..8e7fb87 100644
--- a/src/resources/subscribers/subscribers.ts
+++ b/src/resources/subscribers/subscribers.ts
@@ -80,8 +80,11 @@ export class Subscribers extends APIResource {
   }
 
   /**
-   * Lists subscribers with pagination and optional filtering by status, free-text
-   * query, tags, list, segment, or email.
+   * Lists subscribers with stable pagination and optional filtering by status,
+   * free-text query, tags, list, segment, attribute, or email. Non-attribute results
+   * are ordered by createdAt descending with subscriber ID as a deterministic
+   * tie-breaker. Attribute-filtered results use ClickHouse-first cursor pagination
+   * ordered by subscriber ID ascending and do not include a total count.
    *
    * @example
    * ```ts
@@ -448,6 +451,24 @@ export interface SubscriberUpdateParams {
 }
 
 export interface SubscriberListParams {
+  /**
+   * Custom attribute filter using attributeName:value syntax, such as plan:pro or
+   * mrr:50.
+   */
+  attribute?: string;
+
+  /**
+   * Attribute filter operator for direct cursor pagination. Use saved segments for
+   * exclusion operators such as is_not, not_contains, or is_empty.
+   */
+  attributeOperator?: 'is' | 'contains' | 'gt' | 'gte' | 'lt' | 'lte' | 'is_not_empty';
+
+  /**
+   * Opaque cursor returned as pagination.nextCursor. Only used with attribute
+   * filters.
+   */
+  cursor?: string;
+
   /**
    * Legacy alias for a partial email search
    */
diff --git a/src/version.ts b/src/version.ts
index 288031c..3e76cc4 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '0.27.0'; // x-release-please-version
+export const VERSION = '0.28.0'; // x-release-please-version
diff --git a/tests/api-resources/subscribers/subscribers.test.ts b/tests/api-resources/subscribers/subscribers.test.ts
index 8f18e97..2d3a6c7 100644
--- a/tests/api-resources/subscribers/subscribers.test.ts
+++ b/tests/api-resources/subscribers/subscribers.test.ts
@@ -74,6 +74,9 @@ describe('resource subscribers', () => {
     await expect(
       client.subscribers.list(
         {
+          attribute: 'attribute',
+          attributeOperator: 'is',
+          cursor: 'cursor',
           email: 'email',
           limit: 100,
           list: 'list',