release: 1.5.0 (#18)

Automated Release PR
---


## 1.5.0 (2026-04-10)

Full Changelog:
[v1.4.0...v1.5.0](v1.4.0...v1.5.0)

### Features

* **api:** add currencies/region fields to customers, filters to list
([87d9221](87d9221))
* **api:** remove list method from quotes
([ae6b4e8](ae6b4e8))


### Bug Fixes

* **api:** make customerId required, remove role filter in beneficial
owners list
([ffa8a25](ffa8a25))


### Documentation

* **api:** update crypto_network examples in crypto/external
accounts/quotes
([149bfc9](149bfc9))

---
This pull request is managed by Stainless's [GitHub
App](https://github.com/apps/stainless-app).

The [semver version
number](https://semver.org/#semantic-versioning-specification-semver) is
based on included [commit
messages](https://www.conventionalcommits.org/en/v1.0.0/).
Alternatively, you can manually set the version number in the title of
this pull request.

For a better experience, it is recommended to use either rebase-merge or
squash-merge when merging this pull request.

🔗 Stainless [website](https://www.stainlessapi.com)
📚 Read the [docs](https://app.stainlessapi.com/docs)
🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.4.0"
+  ".": "1.5.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 56
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lightspark%2Fgrid-28cd7f09a1be0028041885e5055718c3aa0ecb738526689a2f064cfac8c177f8.yml
-openapi_spec_hash: c40a82e4c571cd9786f66eebad7aef09
+configured_endpoints: 55
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lightspark%2Fgrid-5f12cb865215bc90309a8fbfc2f86d6cd25f57de9b14e9d95952d4325608e890.yml
+openapi_spec_hash: d6fcf6f0cd3661f395658643848012ea
 config_hash: 46d2b1a1cc0e1e24f91c90fe729be40c

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.5.0 (2026-04-10)
+
+Full Changelog: [v1.4.0...v1.5.0](https://github.com/lightsparkdev/grid-kotlin-sdk/compare/v1.4.0...v1.5.0)
+
+### Features
+
+* **api:** add currencies/region fields to customers, filters to list ([87d9221](https://github.com/lightsparkdev/grid-kotlin-sdk/commit/87d922160615f1ad5f59083ceb4a2bcb0259d1bd))
+* **api:** remove list method from quotes ([ae6b4e8](https://github.com/lightsparkdev/grid-kotlin-sdk/commit/ae6b4e838f052ee945ddfdb2f31b4b7a7113a36b))
+
+
+### Bug Fixes
+
+* **api:** make customerId required, remove role filter in beneficial owners list ([ffa8a25](https://github.com/lightsparkdev/grid-kotlin-sdk/commit/ffa8a255d98c3baff944a23b615a51a1d5335749))
+
+
+### Documentation
+
+* **api:** update crypto_network examples in crypto/external accounts/quotes ([149bfc9](https://github.com/lightsparkdev/grid-kotlin-sdk/commit/149bfc98f9014beb590f47c75983c4b6b9250514))
+
 ## 1.4.0 (2026-04-01)
 
 Full Changelog: [v1.3.0...v1.4.0](https://github.com/lightsparkdev/grid-kotlin-sdk/compare/v1.3.0...v1.4.0)

README.md

@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.lightspark.grid/lightspark-grid-kotlin)](https://central.sonatype.com/artifact/com.lightspark.grid/lightspark-grid-kotlin/1.4.0)
-[![javadoc](https://javadoc.io/badge2/com.lightspark.grid/lightspark-grid-kotlin/1.4.0/javadoc.svg)](https://javadoc.io/doc/com.lightspark.grid/lightspark-grid-kotlin/1.4.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.lightspark.grid/lightspark-grid-kotlin)](https://central.sonatype.com/artifact/com.lightspark.grid/lightspark-grid-kotlin/1.5.0)
+[![javadoc](https://javadoc.io/badge2/com.lightspark.grid/lightspark-grid-kotlin/1.5.0/javadoc.svg)](https://javadoc.io/doc/com.lightspark.grid/lightspark-grid-kotlin/1.5.0)
 
 <!-- x-release-please-end -->
 
@@ -22,7 +22,7 @@ Use the Lightspark Grid MCP Server to enable AI assistants to interact with this
 
 <!-- x-release-please-start-version -->
 
-KDocs are available on [javadoc.io](https://javadoc.io/doc/com.lightspark.grid/lightspark-grid-kotlin/1.4.0).
+KDocs are available on [javadoc.io](https://javadoc.io/doc/com.lightspark.grid/lightspark-grid-kotlin/1.5.0).
 
 <!-- x-release-please-end -->
 
@@ -33,7 +33,7 @@ KDocs are available on [javadoc.io](https://javadoc.io/doc/com.lightspark.grid/l
 ### Gradle
 
 ```kotlin
-implementation("com.lightspark.grid:lightspark-grid-kotlin:1.4.0")
+implementation("com.lightspark.grid:lightspark-grid-kotlin:1.5.0")
 ```
 
 ### Maven
@@ -42,7 +42,7 @@ implementation("com.lightspark.grid:lightspark-grid-kotlin:1.4.0")
 <dependency>
   <groupId>com.lightspark.grid</groupId>
   <artifactId>lightspark-grid-kotlin</artifactId>
-  <version>1.4.0</version>
+  <version>1.5.0</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.lightspark.grid"
-    version = "1.4.0" // x-release-please-version
+    version = "1.5.0" // x-release-please-version
 }
 
 subprojects {

lightspark-grid-kotlin-core/src/main/kotlin/com/lightspark/grid/models/beneficialowners/BeneficialOwnerListParams.kt

@@ -2,38 +2,31 @@
 
 package com.lightspark.grid.models.beneficialowners
 
-import com.fasterxml.jackson.annotation.JsonCreator
-import com.lightspark.grid.core.Enum
-import com.lightspark.grid.core.JsonField
 import com.lightspark.grid.core.Params
+import com.lightspark.grid.core.checkRequired
 import com.lightspark.grid.core.http.Headers
 import com.lightspark.grid.core.http.QueryParams
-import com.lightspark.grid.errors.LightsparkGridInvalidDataException
 import java.util.Objects
 
-/** Retrieve a list of beneficial owners with optional filtering by customer ID and role. */
+/** Retrieve a list of beneficial owners for a business customer. */
 class BeneficialOwnerListParams
 private constructor(
+    private val customerId: String,
     private val cursor: String?,
-    private val customerId: String?,
     private val limit: Long?,
-    private val role: Role?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
+    /** The business customer ID */
+    fun customerId(): String = customerId
+
     /** Cursor for pagination (returned from previous request) */
     fun cursor(): String? = cursor
 
-    /** Filter by business customer ID */
-    fun customerId(): String? = customerId
-
     /** Maximum number of results to return (default 20, max 100) */
     fun limit(): Long? = limit
 
-    /** Filter by role */
-    fun role(): Role? = role
-
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
 
@@ -44,39 +37,40 @@ private constructor(
 
     companion object {
 
-        fun none(): BeneficialOwnerListParams = builder().build()
-
         /**
          * Returns a mutable builder for constructing an instance of [BeneficialOwnerListParams].
+         *
+         * The following fields are required:
+         * ```kotlin
+         * .customerId()
+         * ```
          */
         fun builder() = Builder()
     }
 
     /** A builder for [BeneficialOwnerListParams]. */
     class Builder internal constructor() {
 
-        private var cursor: String? = null
         private var customerId: String? = null
+        private var cursor: String? = null
         private var limit: Long? = null
-        private var role: Role? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         internal fun from(beneficialOwnerListParams: BeneficialOwnerListParams) = apply {
-            cursor = beneficialOwnerListParams.cursor
             customerId = beneficialOwnerListParams.customerId
+            cursor = beneficialOwnerListParams.cursor
             limit = beneficialOwnerListParams.limit
-            role = beneficialOwnerListParams.role
             additionalHeaders = beneficialOwnerListParams.additionalHeaders.toBuilder()
             additionalQueryParams = beneficialOwnerListParams.additionalQueryParams.toBuilder()
         }
 
+        /** The business customer ID */
+        fun customerId(customerId: String) = apply { this.customerId = customerId }
+
         /** Cursor for pagination (returned from previous request) */
         fun cursor(cursor: String?) = apply { this.cursor = cursor }
 
-        /** Filter by business customer ID */
-        fun customerId(customerId: String?) = apply { this.customerId = customerId }
-
         /** Maximum number of results to return (default 20, max 100) */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
@@ -87,9 +81,6 @@ private constructor(
          */
         fun limit(limit: Long) = limit(limit as Long?)
 
-        /** Filter by role */
-        fun role(role: Role?) = apply { this.role = role }
-
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
             putAllAdditionalHeaders(additionalHeaders)
@@ -192,13 +183,19 @@ private constructor(
          * Returns an immutable instance of [BeneficialOwnerListParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```kotlin
+         * .customerId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
          */
         fun build(): BeneficialOwnerListParams =
             BeneficialOwnerListParams(
+                checkRequired("customerId", customerId),
                 cursor,
-                customerId,
                 limit,
-                role,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
             )
@@ -209,181 +206,29 @@ private constructor(
     override fun _queryParams(): QueryParams =
         QueryParams.builder()
             .apply {
+                put("customerId", customerId)
                 cursor?.let { put("cursor", it) }
-                customerId?.let { put("customerId", it) }
                 limit?.let { put("limit", it.toString()) }
-                role?.let { put("role", it.toString()) }
                 putAll(additionalQueryParams)
             }
             .build()
 
-    /** Filter by role */
-    class Role @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
-
-        /**
-         * Returns this class instance's raw value.
-         *
-         * This is usually only useful if this instance was deserialized from data that doesn't
-         * match any known member, and you want to know that value. For example, if the SDK is on an
-         * older version than the API, then the API may respond with new members that the SDK is
-         * unaware of.
-         */
-        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-        companion object {
-
-            val UBO = of("UBO")
-
-            val DIRECTOR = of("DIRECTOR")
-
-            val COMPANY_OFFICER = of("COMPANY_OFFICER")
-
-            val CONTROL_PERSON = of("CONTROL_PERSON")
-
-            val TRUSTEE = of("TRUSTEE")
-
-            val GENERAL_PARTNER = of("GENERAL_PARTNER")
-
-            fun of(value: String) = Role(JsonField.of(value))
-        }
-
-        /** An enum containing [Role]'s known values. */
-        enum class Known {
-            UBO,
-            DIRECTOR,
-            COMPANY_OFFICER,
-            CONTROL_PERSON,
-            TRUSTEE,
-            GENERAL_PARTNER,
-        }
-
-        /**
-         * An enum containing [Role]'s known values, as well as an [_UNKNOWN] member.
-         *
-         * An instance of [Role] can contain an unknown value in a couple of cases:
-         * - It was deserialized from data that doesn't match any known member. For example, if the
-         *   SDK is on an older version than the API, then the API may respond with new members that
-         *   the SDK is unaware of.
-         * - It was constructed with an arbitrary value using the [of] method.
-         */
-        enum class Value {
-            UBO,
-            DIRECTOR,
-            COMPANY_OFFICER,
-            CONTROL_PERSON,
-            TRUSTEE,
-            GENERAL_PARTNER,
-            /** An enum member indicating that [Role] was instantiated with an unknown value. */
-            _UNKNOWN,
-        }
-
-        /**
-         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
-         * if the class was instantiated with an unknown value.
-         *
-         * Use the [known] method instead if you're certain the value is always known or if you want
-         * to throw for the unknown case.
-         */
-        fun value(): Value =
-            when (this) {
-                UBO -> Value.UBO
-                DIRECTOR -> Value.DIRECTOR
-                COMPANY_OFFICER -> Value.COMPANY_OFFICER
-                CONTROL_PERSON -> Value.CONTROL_PERSON
-                TRUSTEE -> Value.TRUSTEE
-                GENERAL_PARTNER -> Value.GENERAL_PARTNER
-                else -> Value._UNKNOWN
-            }
-
-        /**
-         * Returns an enum member corresponding to this class instance's value.
-         *
-         * Use the [value] method instead if you're uncertain the value is always known and don't
-         * want to throw for the unknown case.
-         *
-         * @throws LightsparkGridInvalidDataException if this class instance's value is a not a
-         *   known member.
-         */
-        fun known(): Known =
-            when (this) {
-                UBO -> Known.UBO
-                DIRECTOR -> Known.DIRECTOR
-                COMPANY_OFFICER -> Known.COMPANY_OFFICER
-                CONTROL_PERSON -> Known.CONTROL_PERSON
-                TRUSTEE -> Known.TRUSTEE
-                GENERAL_PARTNER -> Known.GENERAL_PARTNER
-                else -> throw LightsparkGridInvalidDataException("Unknown Role: $value")
-            }
-
-        /**
-         * Returns this class instance's primitive wire representation.
-         *
-         * This differs from the [toString] method because that method is primarily for debugging
-         * and generally doesn't throw.
-         *
-         * @throws LightsparkGridInvalidDataException if this class instance's value does not have
-         *   the expected primitive type.
-         */
-        fun asString(): String =
-            _value().asString() ?: throw LightsparkGridInvalidDataException("Value is not a String")
-
-        private var validated: Boolean = false
-
-        fun validate(): Role = apply {
-            if (validated) {
-                return@apply
-            }
-
-            known()
-            validated = true
-        }
-
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: LightsparkGridInvalidDataException) {
-                false
-            }
-
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
-
-            return other is Role && value == other.value
-        }
-
-        override fun hashCode() = value.hashCode()
-
-        override fun toString() = value.toString()
-    }
-
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
         }
 
         return other is BeneficialOwnerListParams &&
-            cursor == other.cursor &&
             customerId == other.customerId &&
+            cursor == other.cursor &&
             limit == other.limit &&
-            role == other.role &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
     override fun hashCode(): Int =
-        Objects.hash(cursor, customerId, limit, role, additionalHeaders, additionalQueryParams)
+        Objects.hash(customerId, cursor, limit, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "BeneficialOwnerListParams{cursor=$cursor, customerId=$customerId, limit=$limit, role=$role, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "BeneficialOwnerListParams{customerId=$customerId, cursor=$cursor, limit=$limit, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }