release: 0.143.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.142.0"
+  ".": "0.143.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 214
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-185b3d93b4e6ed5ae02c32f0bc9133b0ac99dcd1263a12b7aa9ba64e71a5461e.yml
-openapi_spec_hash: 2418116f58a464afdd5611865e860d30
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-47e9f78d22682623e313f1689f5fa7e3420575ff285a14a2f4704c49ffb6b72e.yml
+openapi_spec_hash: 4797fe46d942cb32e648a79015783d01
 config_hash: 5bb913c05ebeb301ec925b16e75bb251

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.143.0 (2026-06-23)
+
+Full Changelog: [v0.142.0...v0.143.0](https://github.com/lithic-com/lithic-node/compare/v0.142.0...v0.143.0)
+
+### Features
+
+* **api:** add claim and claim_document webhook events ([0fa2723](https://github.com/lithic-com/lithic-node/commit/0fa2723a5ee4fe9dece58a2b43bb65a6b6b04958))
+* **api:** add external bank/payment velocity/decline history features to auth_rules.v2 ([36a5b96](https://github.com/lithic-com/lithic-node/commit/36a5b96edf49100892ca36d6dc3931eba1c99603))
+
 ## 0.142.0 (2026-06-22)
 
 Full Changelog: [v0.141.0...v0.142.0](https://github.com/lithic-com/lithic-node/compare/v0.141.0...v0.142.0)

api.md

@@ -903,6 +903,11 @@ Types:
 - <code><a href="./src/resources/webhooks.ts">CardTransactionUpdatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">CardTransactionEnhancedDataCreatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">CardTransactionEnhancedDataUpdatedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">ClaimCreatedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">ClaimUpdatedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">ClaimDocumentUploadedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">ClaimDocumentAcceptedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">ClaimDocumentRejectedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">DigitalWalletTokenizationApprovalRequestWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">DigitalWalletTokenizationResultWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent</a></code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithic",
-  "version": "0.142.0",
+  "version": "0.143.0",
   "description": "The official TypeScript library for the Lithic API",
   "author": "Lithic <sdk-feedback@lithic.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "lithic-mcp",
-  "version": "0.142.0",
+  "version": "0.143.0",
   "description": "The official MCP Server for the Lithic API",
   "author": {
     "name": "Lithic",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithic-mcp",
-  "version": "0.142.0",
+  "version": "0.143.0",
   "description": "The official MCP Server for the Lithic API",
   "author": "Lithic <sdk-feedback@lithic.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/server.ts

@@ -29,7 +29,7 @@ export const newMcpServer = async ({
   new McpServer(
     {
       name: 'lithic_api',
-      version: '0.142.0',
+      version: '0.143.0',
     },
     {
       instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),

src/client.ts

@@ -211,6 +211,11 @@ import {
   CardTransactionEnhancedDataUpdatedWebhookEvent,
   CardTransactionUpdatedWebhookEvent,
   CardUpdatedWebhookEvent,
+  ClaimCreatedWebhookEvent,
+  ClaimDocumentAcceptedWebhookEvent,
+  ClaimDocumentRejectedWebhookEvent,
+  ClaimDocumentUploadedWebhookEvent,
+  ClaimUpdatedWebhookEvent,
   DigitalWalletTokenizationApprovalRequestWebhookEvent,
   DigitalWalletTokenizationResultWebhookEvent,
   DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent,
@@ -1606,6 +1611,11 @@ export declare namespace Lithic {
     type CardTransactionUpdatedWebhookEvent as CardTransactionUpdatedWebhookEvent,
     type CardTransactionEnhancedDataCreatedWebhookEvent as CardTransactionEnhancedDataCreatedWebhookEvent,
     type CardTransactionEnhancedDataUpdatedWebhookEvent as CardTransactionEnhancedDataUpdatedWebhookEvent,
+    type ClaimCreatedWebhookEvent as ClaimCreatedWebhookEvent,
+    type ClaimUpdatedWebhookEvent as ClaimUpdatedWebhookEvent,
+    type ClaimDocumentUploadedWebhookEvent as ClaimDocumentUploadedWebhookEvent,
+    type ClaimDocumentAcceptedWebhookEvent as ClaimDocumentAcceptedWebhookEvent,
+    type ClaimDocumentRejectedWebhookEvent as ClaimDocumentRejectedWebhookEvent,
     type DigitalWalletTokenizationApprovalRequestWebhookEvent as DigitalWalletTokenizationApprovalRequestWebhookEvent,
     type DigitalWalletTokenizationResultWebhookEvent as DigitalWalletTokenizationResultWebhookEvent,
     type DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent as DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent,

src/resources/auth-rules/v2/v2.ts

@@ -2093,6 +2093,8 @@ export namespace ReportStats {
  *   CARD_TRANSACTION_UPDATE event stream rules.
  * - `ACH_PAYMENT`: The ACH payment being evaluated. Only available for
  *   ACH_PAYMENT_UPDATE event stream rules.
+ * - `EXTERNAL_BANK_ACCOUNT`: The external bank account tied to the ACH payment
+ *   being evaluated. Only available for ACH_PAYMENT_UPDATE event stream rules.
  * - `CARD`: The card associated with the event. Available for AUTHORIZATION,
  *   THREE_DS_AUTHENTICATION, and CARD_TRANSACTION_UPDATE event stream rules.
  * - `ACCOUNT_HOLDER`: The account holder associated with the event. Available for
@@ -2102,7 +2104,17 @@ export namespace ReportStats {
  *   THREE_DS_AUTHENTICATION event stream rules.
  * - `SPEND_VELOCITY`: Spend velocity data for the card or account. Requires
  *   `scope`, `period`, and optionally `filters` to configure the velocity
- *   calculation. Available for AUTHORIZATION event stream rules.
+ *   calculation. Available for AUTHORIZATION and CARD_TRANSACTION_UPDATE event
+ *   stream rules.
+ * - `PAYMENT_VELOCITY`: ACH payment velocity data, aggregated over the given
+ *   scope. Requires `scope`, `period`, and optionally `filters` to configure the
+ *   velocity calculation. Available for ACH_PAYMENT_UPDATE event stream rules.
+ * - `CONSECUTIVE_DECLINES`: The number of consecutive declined transactions since
+ *   the last approval for the card or account. Requires `scope`. Available for
+ *   AUTHORIZATION and CARD_TRANSACTION_UPDATE event stream rules.
+ * - `ACH_PAYMENT_HISTORY`: Windowed settled-amount statistics derived from the
+ *   financial account's ACH payment history. Requires `scope`. Available for
+ *   ACH_PAYMENT_UPDATE event stream rules.
  * - `TRANSACTION_HISTORY_SIGNALS`: Behavioral feature state derived from the
  *   entity's transaction history. Requires `scope` to specify whether to load
  *   card, account, or business account history. Available for AUTHORIZATION and
@@ -2115,11 +2127,15 @@ export type RuleFeature =
   | RuleFeature.ACHReceiptFeature
   | RuleFeature.CardTransactionFeature
   | RuleFeature.ACHPaymentFeature
+  | RuleFeature.ExternalBankAccountFeature
   | RuleFeature.CardFeature
   | RuleFeature.AccountHolderFeature
   | RuleFeature.IPMetadataFeature
   | RuleFeature.SpendVelocityFeature
-  | RuleFeature.TransactionHistorySignalsFeature;
+  | RuleFeature.PaymentVelocityFeature
+  | RuleFeature.TransactionHistorySignalsFeature
+  | RuleFeature.ConsecutiveDeclinesFeature
+  | RuleFeature.ACHPaymentHistoryFeature;
 
 export namespace RuleFeature {
   export interface AuthorizationFeature {
@@ -2176,6 +2192,15 @@ export namespace RuleFeature {
     name?: string;
   }
 
+  export interface ExternalBankAccountFeature {
+    type: 'EXTERNAL_BANK_ACCOUNT';
+
+    /**
+     * The variable name for this feature in the rule function signature
+     */
+    name?: string;
+  }
+
   export interface CardFeature {
     type: 'CARD';
 
@@ -2224,6 +2249,71 @@ export namespace RuleFeature {
     name?: string;
   }
 
+  export interface PaymentVelocityFeature {
+    /**
+     * Velocity over the current day since 00:00 / 12 AM in Eastern Time
+     */
+    period: V2API.VelocityLimitPeriod;
+
+    /**
+     * The scope over which the ACH payment velocity is aggregated.
+     */
+    scope: 'FINANCIAL_ACCOUNT' | 'GLOBAL';
+
+    type: 'PAYMENT_VELOCITY';
+
+    /**
+     * Optional filters applied when aggregating ACH payment velocity. Payments not
+     * matching the provided filters are excluded from the calculated velocity.
+     */
+    filters?: PaymentVelocityFeature.Filters;
+
+    /**
+     * The variable name for this feature in the rule function signature
+     */
+    name?: string;
+  }
+
+  export namespace PaymentVelocityFeature {
+    /**
+     * Optional filters applied when aggregating ACH payment velocity. Payments not
+     * matching the provided filters are excluded from the calculated velocity.
+     */
+    export interface Filters {
+      /**
+       * Exclude payments matching any of the provided tag key-value pairs.
+       */
+      exclude_tags?: { [key: string]: string } | null;
+
+      /**
+       * Payment types to include in the velocity calculation.
+       */
+      include_payment_types?: Array<'ORIGINATION' | 'RECEIPT'> | null;
+
+      /**
+       * Payment polarities to include in the velocity calculation.
+       */
+      include_polarities?: Array<'CREDIT' | 'DEBIT'> | null;
+
+      /**
+       * Payment statuses to include in the velocity calculation.
+       */
+      include_statuses?: Array<
+        'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED'
+      > | null;
+
+      /**
+       * Only include payments matching all of the provided tag key-value pairs.
+       */
+      include_tags?: { [key: string]: string } | null;
+
+      /**
+       * Only include payments with the given result.
+       */
+      result?: 'APPROVED' | 'DECLINED';
+    }
+  }
+
   export interface TransactionHistorySignalsFeature {
     /**
      * The entity scope to load transaction history signals for.
@@ -2237,6 +2327,34 @@ export namespace RuleFeature {
      */
     name?: string;
   }
+
+  export interface ConsecutiveDeclinesFeature {
+    /**
+     * The entity scope to count consecutive declines for.
+     */
+    scope: 'CARD' | 'ACCOUNT';
+
+    type: 'CONSECUTIVE_DECLINES';
+
+    /**
+     * The variable name for this feature in the rule function signature
+     */
+    name?: string;
+  }
+
+  export interface ACHPaymentHistoryFeature {
+    /**
+     * The entity scope to load ACH payment history for.
+     */
+    scope: 'FINANCIAL_ACCOUNT';
+
+    type: 'ACH_PAYMENT_HISTORY';
+
+    /**
+     * The variable name for this feature in the rule function signature
+     */
+    name?: string;
+  }
 }
 
 export interface SpendVelocityFilters extends VelocityLimitFilters {

src/resources/events/events.ts

@@ -127,6 +127,15 @@ export interface Event {
    * - card.renewed: Occurs when a card is renewed.
    * - card.shipped: Occurs when a card is shipped.
    * - card.updated: Occurs when a card is updated.
+   * - claim_document.accepted: Occurs when a claim document passes validation and is
+   *   accepted.
+   * - claim_document.rejected: Occurs when a claim document fails validation and is
+   *   rejected.
+   * - claim_document.uploaded: Occurs when a claim document is uploaded and begins
+   *   validation.
+   * - claim.created: Occurs when a dispute intake claim is created.
+   * - claim.updated: Occurs when a dispute intake claim is updated, such as a status
+   *   change or a change to its outstanding requirements.
    * - digital_wallet.tokenization_result: Occurs when a tokenization request
    *   succeeded or failed.
    *
@@ -220,6 +229,11 @@ export interface Event {
     | 'card.renewed'
     | 'card.shipped'
     | 'card.updated'
+    | 'claim_document.accepted'
+    | 'claim_document.rejected'
+    | 'claim_document.uploaded'
+    | 'claim.created'
+    | 'claim.updated'
     | 'digital_wallet.tokenization_result'
     | 'digital_wallet.tokenization_two_factor_authentication_code'
     | 'digital_wallet.tokenization_two_factor_authentication_code_sent'
@@ -300,6 +314,11 @@ export interface EventSubscription {
     | 'card.renewed'
     | 'card.shipped'
     | 'card.updated'
+    | 'claim_document.accepted'
+    | 'claim_document.rejected'
+    | 'claim_document.uploaded'
+    | 'claim.created'
+    | 'claim.updated'
     | 'digital_wallet.tokenization_result'
     | 'digital_wallet.tokenization_two_factor_authentication_code'
     | 'digital_wallet.tokenization_two_factor_authentication_code_sent'
@@ -418,6 +437,11 @@ export interface EventListParams extends CursorPageParams {
     | 'card.renewed'
     | 'card.shipped'
     | 'card.updated'
+    | 'claim_document.accepted'
+    | 'claim_document.rejected'
+    | 'claim_document.uploaded'
+    | 'claim.created'
+    | 'claim.updated'
     | 'digital_wallet.tokenization_result'
     | 'digital_wallet.tokenization_two_factor_authentication_code'
     | 'digital_wallet.tokenization_two_factor_authentication_code_sent'

src/resources/events/subscriptions.ts

@@ -186,6 +186,11 @@ export interface SubscriptionCreateParams {
     | 'card.renewed'
     | 'card.shipped'
     | 'card.updated'
+    | 'claim_document.accepted'
+    | 'claim_document.rejected'
+    | 'claim_document.uploaded'
+    | 'claim.created'
+    | 'claim.updated'
     | 'digital_wallet.tokenization_result'
     | 'digital_wallet.tokenization_two_factor_authentication_code'
     | 'digital_wallet.tokenization_two_factor_authentication_code_sent'
@@ -264,6 +269,11 @@ export interface SubscriptionUpdateParams {
     | 'card.renewed'
     | 'card.shipped'
     | 'card.updated'
+    | 'claim_document.accepted'
+    | 'claim_document.rejected'
+    | 'claim_document.uploaded'
+    | 'claim.created'
+    | 'claim.updated'
     | 'digital_wallet.tokenization_result'
     | 'digital_wallet.tokenization_two_factor_authentication_code'
     | 'digital_wallet.tokenization_two_factor_authentication_code_sent'
@@ -372,6 +382,11 @@ export interface SubscriptionSendSimulatedExampleParams {
     | 'card.renewed'
     | 'card.shipped'
     | 'card.updated'
+    | 'claim_document.accepted'
+    | 'claim_document.rejected'
+    | 'claim_document.uploaded'
+    | 'claim.created'
+    | 'claim.updated'
     | 'digital_wallet.tokenization_result'
     | 'digital_wallet.tokenization_two_factor_authentication_code'
     | 'digital_wallet.tokenization_two_factor_authentication_code_sent'

src/resources/index.ts

@@ -321,6 +321,11 @@ export {
   type CardTransactionUpdatedWebhookEvent,
   type CardTransactionEnhancedDataCreatedWebhookEvent,
   type CardTransactionEnhancedDataUpdatedWebhookEvent,
+  type ClaimCreatedWebhookEvent,
+  type ClaimUpdatedWebhookEvent,
+  type ClaimDocumentUploadedWebhookEvent,
+  type ClaimDocumentAcceptedWebhookEvent,
+  type ClaimDocumentRejectedWebhookEvent,
   type DigitalWalletTokenizationApprovalRequestWebhookEvent,
   type DigitalWalletTokenizationResultWebhookEvent,
   type DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent,