Update to Plaid v1.631.0

Author: viceroypenguin

plaid-openapi

@@ -62,12 +62,12 @@ public partial class WebhookBaseConverter : JsonConverter<WebhookBase>
 			[(WebhookType.Item, WebhookCode.UserAccountRevoked)] = typeof(UserAccountRevokedWebhook),
 			[(WebhookType.Statements, WebhookCode.StatementsRefreshComplete)] = typeof(StatementsRefreshCompleteWebhook),
 			[(WebhookType.CraMonitoring, WebhookCode.InsightsUpdated)] = typeof(MonitoringInsightsWebhook),
-			[(WebhookType.CraMonitoring, WebhookCode.NsfOverdraftDetected)] = typeof(MonitoringInsightsNSFWebhook),
-			[(WebhookType.CraMonitoring, WebhookCode.NewIncomeStreamDetected)] = typeof(MonitoringInsightsNewIncomeStreamWebhook),
-			[(WebhookType.CraMonitoring, WebhookCode.ExpectedDepositMissed)] = typeof(MonitoringInsightsExpectedDepositMissedWebhook),
-			[(WebhookType.CraMonitoring, WebhookCode.LowBalanceDetected)] = typeof(MonitoringInsightsLowBalanceWebhook),
-			[(WebhookType.CraMonitoring, WebhookCode.LargeDepositDetected)] = typeof(MonitoringInsightsLargeDepositWebhook),
-			[(WebhookType.CraMonitoring, WebhookCode.NewLoanPaymentDetected)] = typeof(MonitoringInsightsNewLoanPaymentWebhook),
+			[(WebhookType.CashFlowUpdates, WebhookCode.NsfOverdraftDetected)] = typeof(CashFlowUpdatesNSFWebhook),
+			[(WebhookType.CashFlowUpdates, WebhookCode.NewIncomeStreamDetected)] = typeof(CashFlowUpdatesNewIncomeStreamWebhook),
+			[(WebhookType.CashFlowUpdates, WebhookCode.ExpectedDepositMissed)] = typeof(CashFlowUpdatesExpectedDepositMissedWebhook),
+			[(WebhookType.CashFlowUpdates, WebhookCode.LowBalanceDetected)] = typeof(CashFlowUpdatesLowBalanceWebhook),
+			[(WebhookType.CashFlowUpdates, WebhookCode.LargeDepositDetected)] = typeof(CashFlowUpdatesLargeDepositWebhook),
+			[(WebhookType.CashFlowUpdates, WebhookCode.NewLoanPaymentDetected)] = typeof(CashFlowUpdatesNewLoanPaymentWebhook),
 			[(WebhookType.BaseReport, WebhookCode.Error)] = typeof(BaseReportsErrorWebhook),
 			[(WebhookType.CraIncome, WebhookCode.BankIncomeComplete)] = typeof(CraBankIncomeCompleteWebhook),
 			[(WebhookType.CraIncome, WebhookCode.Error)] = typeof(CraBankIncomeErrorWebhook),

src/Plaid/Converters/WebhookBaseConverter.Map.cs

@@ -11,4 +11,10 @@ public record CraCheckReportCashflowInsightsGetResponse : ResponseBase
 	[JsonPropertyName("report")]
 	public Entity.CraCashflowInsightsReport Report { get; init; } = default!;
 
+	/// <summary>
+	/// <para>If the Cashflow Insights generation was successful but a subset of data could not be retrieved, this array will contain information about the errors causing information to be missing</para>
+	/// </summary>
+	[JsonPropertyName("warnings")]
+	public IReadOnlyList<Entity.CraReportWarning>? Warnings { get; init; } = default!;
+
 }

src/Plaid/Cra/CraCheckReportCashflowInsightsGetResponse.cs

@@ -30,7 +30,13 @@ public partial class CraCheckReportCreateRequest : RequestBase
 	public int? DaysRequired { get; set; } = default!;
 
 	/// <summary>
-	/// <para>Specifies a list of products that will be eagerly generated when creating the report. These products will be made available before a success webhook is sent. Use this option to minimize response latency for product <c>/get</c> endpoints.</para>
+	/// <para>Client-generated identifier, which can be used by lenders to track loan applications.</para>
+	/// </summary>
+	[JsonPropertyName("client_report_id")]
+	public string? ClientReportId { get; set; } = default!;
+
+	/// <summary>
+	/// <para>Specifies a list of products that will be eagerly generated when creating the report (in addition to the Base Report, which is always eagerly generated). These products will be made available before a success webhook is sent. Use this option to minimize response latency for product <c>/get</c> endpoints. Note that specifying <c>cra_partner_insights</c> in this field will trigger a billable event. Other products are not billed until the respective reports are fetched via product-specific <c>/get</c> endpoints.</para>
 	/// </summary>
 	[JsonPropertyName("products")]
 	public IReadOnlyList<Entity.Products>? Products { get; set; } = default!;

src/Plaid/Cra/CraCheckReportCreateRequest.cs

@@ -11,4 +11,10 @@ public record CraCheckReportIncomeInsightsGetResponse : ResponseBase
 	[JsonPropertyName("report")]
 	public Entity.CraIncomeInsights? Report { get; init; } = default!;
 
+	/// <summary>
+	/// <para>If the Income Insights generation was successful but a subset of data could not be retrieved, this array will contain information about the errors causing information to be missing</para>
+	/// </summary>
+	[JsonPropertyName("warnings")]
+	public IReadOnlyList<Entity.CraReportWarning>? Warnings { get; init; } = default!;
+
 }

src/Plaid/Cra/CraCheckReportIncomeInsightsGetResponse.cs

@@ -11,4 +11,10 @@ public record CraCheckReportNetworkInsightsGetResponse : ResponseBase
 	[JsonPropertyName("report")]
 	public Entity.CraNetworkInsightsReport Report { get; init; } = default!;
 
+	/// <summary>
+	/// <para>If the Network Insights generation was successful but a subset of data could not be retrieved, this array will contain information about the errors causing information to be missing</para>
+	/// </summary>
+	[JsonPropertyName("warnings")]
+	public IReadOnlyList<Entity.CraReportWarning>? Warnings { get; init; } = default!;
+
 }

src/Plaid/Cra/CraCheckReportNetworkInsightsGetResponse.cs

@@ -11,4 +11,10 @@ public record CraCheckReportPartnerInsightsGetResponse : ResponseBase
 	[JsonPropertyName("report")]
 	public Entity.CraPartnerInsights? Report { get; init; } = default!;
 
+	/// <summary>
+	/// <para>If the Partner Insights generation was successful but a subset of data could not be retrieved, this array will contain information about the errors causing information to be missing</para>
+	/// </summary>
+	[JsonPropertyName("warnings")]
+	public IReadOnlyList<Entity.CraReportWarning>? Warnings { get; init; } = default!;
+
 }

src/Plaid/Cra/CraCheckReportPartnerInsightsGetResponse.cs

@@ -17,4 +17,10 @@ public partial class CraMonitoringInsightsSubscribeRequest : RequestBase
 	[JsonPropertyName("webhook")]
 	public string Webhook { get; set; } = default!;
 
+	/// <summary>
+	/// <para>Income categories to include in Cash Flow Updates. If empty or <c>null</c>, this field will default to including all possible categories.</para>
+	/// </summary>
+	[JsonPropertyName("income_categories")]
+	public IReadOnlyList<Entity.CreditBankIncomeCategory>? IncomeCategories { get; set; } = default!;
+
 }

src/Plaid/Cra/CraMonitoringInsightsSubscribeRequest.cs

@@ -69,7 +69,7 @@ public record Account
 	public Entity.VerificationInsights? VerificationInsights { get; init; } = default!;
 
 	/// <summary>
-	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
+	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC, and in May 2025 US Bank). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
 	/// </summary>
 	[JsonPropertyName("persistent_account_id")]
 	public string? PersistentAccountId { get; init; } = default!;

src/Plaid/Entity/Account.cs

@@ -81,10 +81,10 @@ public record AccountAssets
 	public IReadOnlyList<Entity.AssetReportTransaction> Transactions { get; init; } = default!;
 
 	/// <summary>
-	/// <para>A transaction within an investment account.</para>
+	/// <para>A set of fields describing the investments data on an account.</para>
 	/// </summary>
 	[JsonPropertyName("investments")]
-	public Entity.AssetReportInvestmentTransaction? Investments { get; init; } = default!;
+	public Entity.AssetReportInvestments? Investments { get; init; } = default!;
 
 	/// <summary>
 	/// <para>Data returned by the financial institution about the account owner or owners.For business accounts, the name reported may be either the name of the individual or the name of the business, depending on the institution. Multiple owners on a single account will be represented in the same <c>owner</c> object, not in multiple owner objects within the array. In API versions 2018-05-22 and earlier, the <c>owners</c> object is not returned, and instead identity information is returned in the top level <c>identity</c> object. For more details, see <a href="https://plaid.com/docs/api/versioning/#version-2019-05-29">Plaid API versioning</a></para>

src/Plaid/Entity/AccountAssets.cs

@@ -69,7 +69,7 @@ public record AccountIdentity
 	public Entity.VerificationInsights? VerificationInsights { get; init; } = default!;
 
 	/// <summary>
-	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
+	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC, and in May 2025 US Bank). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
 	/// </summary>
 	[JsonPropertyName("persistent_account_id")]
 	public string? PersistentAccountId { get; init; } = default!;

src/Plaid/Entity/AccountIdentity.cs

@@ -69,7 +69,7 @@ public record AccountIdentityDocumentUpload
 	public Entity.VerificationInsights? VerificationInsights { get; init; } = default!;
 
 	/// <summary>
-	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
+	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC, and in May 2025 US Bank). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
 	/// </summary>
 	[JsonPropertyName("persistent_account_id")]
 	public string? PersistentAccountId { get; init; } = default!;

src/Plaid/Entity/AccountIdentityDocumentUpload.cs

@@ -69,7 +69,7 @@ public record AccountIdentityMatchScore
 	public Entity.VerificationInsights? VerificationInsights { get; init; } = default!;
 
 	/// <summary>
-	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
+	/// <para>A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC, and in May 2025 US Bank). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (<c>ins_56</c>, <c>ins_13</c>) as well as the OAuth Sandbox institution (<c>ins_127287</c>); in Production, it will only be populated for accounts at applicable institutions.</para>
 	/// </summary>
 	[JsonPropertyName("persistent_account_id")]
 	public string? PersistentAccountId { get; init; } = default!;

src/Plaid/Entity/AccountIdentityMatchScore.cs

@@ -12,19 +12,19 @@ public enum AchClass
 	Ccd,
 
 	/// <summary>
-	/// <para>Prearranged Payment or Deposit - the transfer is part of a pre-existing relationship with a consumer, e.g. bill payment</para>
+	/// <para>Prearranged Payment or Deposit - The transfer is part of a pre-existing relationship with a consumer. Authorization was obtained in writing either in person or via an electronic document signing, e.g. Docusign, by the consumer. Can be used for credits or debits.</para>
 	/// </summary>
 	[EnumMember(Value = "ppd")]
 	Ppd,
 
 	/// <summary>
-	/// <para>Telephone-Initiated Entry</para>
+	/// <para>Telephone-Initiated Entry. The transfer debits a consumer. Debit authorization has been received orally over the telephone via a recorded call.</para>
 	/// </summary>
 	[EnumMember(Value = "tel")]
 	Tel,
 
 	/// <summary>
-	/// <para>Internet-Initiated Entry - debits from a consumer’s account where their authorization is obtained over the Internet</para>
+	/// <para>Internet-Initiated Entry. The transfer debits a consumer’s bank account. Authorization from the consumer is obtained over the Internet (e.g. a web or mobile application). Can be used for single debits or recurring debits.</para>
 	/// </summary>
 	[EnumMember(Value = "web")]
 	Web,

src/Plaid/Entity/AchClass.cs

@@ -1,7 +1,7 @@
 namespace Going.Plaid.Entity;
 
 /// <summary>
-/// <para>A list of add-ons that should be included in the Asset Report.</para>
+/// <para>Add-ons that should be included in the Asset Report.</para>
 /// </summary>
 public enum AssetReportAddOns
 {

src/Plaid/Entity/AssetReportAddOns.cs

@@ -32,7 +32,9 @@ public class AssetReportCreateRequestOptions
 	public IReadOnlyList<string>? Products { get; set; } = default!;
 
 	/// <summary>
-	/// <para>This field can be used to add additional options for the Asset Report. To fetch <c>investments</c> data (transactions, holdings, etc.) in the Asset Report, <c>investments</c> must be specified in <c>add_ons</c>. For Fast Assets, <c>fast_assets</c> must be specified in <c>add_ons</c>.</para>
+	/// <para>A list of add-ons that should be included in the Asset Report.</para>
+	/// <para><c>fast_assets</c>: When Fast Assets is requested, Plaid will create two versions of the Asset Report: the Fast Asset Report, which will contain only Identity and Balance information, and the Full Asset Report, which will also contain Transactions information. A <c>PRODUCT_READY</c> webhook will be fired for each Asset Report when it is ready, and the <c>report_type</c> field will indicate whether the webhook is firing for the <c>full</c> or <c>fast</c> Asset Report. To retrieve the Fast Asset Report, call <c>/asset_report/get</c> with <c>fast_report</c> set to <c>true</c>. There is no additional charge for using Fast Assets. To create a Fast Asset Report, Plaid must successfully retrieve both Identity and Balance data; if Plaid encounters an error obtaining this data, the Fast Asset Report will not be created. However, as long as Plaid can obtain Transactions data, the Full Asset Report will still be available.</para>
+	/// <para><c>investments</c>: Request an Asset Report with Investments. To properly fetch investments data, <c>investments</c> must be specified in the <c>optional_products</c> array when initializing Link.</para>
 	/// </summary>
 	[JsonPropertyName("add_ons")]
 	public IReadOnlyList<Entity.AssetReportAddOns>? AddOns { get; set; } = default!;