feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 236
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-5c95dd79214af830e2e7fb34ab05f98bde9213311d5e2d59f9a816a8e0369b85.yml
-openapi_spec_hash: ec66c2961a8b90e06ea57f934d8d75db
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-6cc15216773be06ef5899a9f805480d69ba2e610a3746bb638c7773baa10c407.yml
+openapi_spec_hash: c24d9a85acb17d73e8d6434d7c907d40
 config_hash: 25d7d7aa4882db6189b4b53e8e249e80

beneficialowner.go

@@ -128,9 +128,8 @@ type EntityBeneficialOwner struct {
 	Prongs []EntityBeneficialOwnerProng `json:"prongs" api:"required"`
 	// A constant representing the object's type. For this resource it will always be
 	// `entity_beneficial_owner`.
-	Type        EntityBeneficialOwnerType `json:"type" api:"required"`
-	ExtraFields map[string]interface{}    `json:"-" api:"extrafields"`
-	JSON        entityBeneficialOwnerJSON `json:"-"`
+	Type EntityBeneficialOwnerType `json:"type" api:"required"`
+	JSON entityBeneficialOwnerJSON `json:"-"`
 }
 
 // entityBeneficialOwnerJSON contains the JSON metadata for the struct

entity.go

@@ -198,7 +198,7 @@ type EntityCorporation struct {
 	Address EntityCorporationAddress `json:"address" api:"required"`
 	// The identifying details of anyone controlling or owning 25% or more of the
 	// corporation.
-	BeneficialOwners []EntityBeneficialOwner `json:"beneficial_owners" api:"required"`
+	BeneficialOwners []EntityCorporationBeneficialOwner `json:"beneficial_owners" api:"required"`
 	// An email address for the business.
 	Email string `json:"email" api:"required,nullable"`
 	// The two-letter United States Postal Service (USPS) abbreviation for the
@@ -275,6 +275,172 @@ func (r entityCorporationAddressJSON) RawJSON() string {
 	return r.raw
 }
 
+type EntityCorporationBeneficialOwner struct {
+	// The identifier of this beneficial owner.
+	ID string `json:"id" api:"required"`
+	// This person's role or title within the entity.
+	CompanyTitle string `json:"company_title" api:"required,nullable"`
+	// Personal details for the beneficial owner.
+	Individual EntityCorporationBeneficialOwnersIndividual `json:"individual" api:"required"`
+	// Why this person is considered a beneficial owner of the entity.
+	Prongs      []EntityCorporationBeneficialOwnersProng `json:"prongs" api:"required"`
+	ExtraFields map[string]interface{}                   `json:"-" api:"extrafields"`
+	JSON        entityCorporationBeneficialOwnerJSON     `json:"-"`
+}
+
+// entityCorporationBeneficialOwnerJSON contains the JSON metadata for the struct
+// [EntityCorporationBeneficialOwner]
+type entityCorporationBeneficialOwnerJSON struct {
+	ID           apijson.Field
+	CompanyTitle apijson.Field
+	Individual   apijson.Field
+	Prongs       apijson.Field
+	raw          string
+	ExtraFields  map[string]apijson.Field
+}
+
+func (r *EntityCorporationBeneficialOwner) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r entityCorporationBeneficialOwnerJSON) RawJSON() string {
+	return r.raw
+}
+
+// Personal details for the beneficial owner.
+type EntityCorporationBeneficialOwnersIndividual struct {
+	// The person's address.
+	Address EntityCorporationBeneficialOwnersIndividualAddress `json:"address" api:"required"`
+	// The person's date of birth in YYYY-MM-DD format.
+	DateOfBirth time.Time `json:"date_of_birth" api:"required" format:"date"`
+	// A means of verifying the person's identity.
+	Identification EntityCorporationBeneficialOwnersIndividualIdentification `json:"identification" api:"required"`
+	// The person's legal name.
+	Name string                                          `json:"name" api:"required"`
+	JSON entityCorporationBeneficialOwnersIndividualJSON `json:"-"`
+}
+
+// entityCorporationBeneficialOwnersIndividualJSON contains the JSON metadata for
+// the struct [EntityCorporationBeneficialOwnersIndividual]
+type entityCorporationBeneficialOwnersIndividualJSON struct {
+	Address        apijson.Field
+	DateOfBirth    apijson.Field
+	Identification apijson.Field
+	Name           apijson.Field
+	raw            string
+	ExtraFields    map[string]apijson.Field
+}
+
+func (r *EntityCorporationBeneficialOwnersIndividual) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r entityCorporationBeneficialOwnersIndividualJSON) RawJSON() string {
+	return r.raw
+}
+
+// The person's address.
+type EntityCorporationBeneficialOwnersIndividualAddress struct {
+	// The city, district, town, or village of the address.
+	City string `json:"city" api:"required,nullable"`
+	// The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+	Country string `json:"country" api:"required"`
+	// The first line of the address.
+	Line1 string `json:"line1" api:"required"`
+	// The second line of the address.
+	Line2 string `json:"line2" api:"required,nullable"`
+	// The two-letter United States Postal Service (USPS) abbreviation for the US
+	// state, province, or region of the address.
+	State string `json:"state" api:"required,nullable"`
+	// The ZIP or postal code of the address.
+	Zip  string                                                 `json:"zip" api:"required,nullable"`
+	JSON entityCorporationBeneficialOwnersIndividualAddressJSON `json:"-"`
+}
+
+// entityCorporationBeneficialOwnersIndividualAddressJSON contains the JSON
+// metadata for the struct [EntityCorporationBeneficialOwnersIndividualAddress]
+type entityCorporationBeneficialOwnersIndividualAddressJSON struct {
+	City        apijson.Field
+	Country     apijson.Field
+	Line1       apijson.Field
+	Line2       apijson.Field
+	State       apijson.Field
+	Zip         apijson.Field
+	raw         string
+	ExtraFields map[string]apijson.Field
+}
+
+func (r *EntityCorporationBeneficialOwnersIndividualAddress) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r entityCorporationBeneficialOwnersIndividualAddressJSON) RawJSON() string {
+	return r.raw
+}
+
+// A means of verifying the person's identity.
+type EntityCorporationBeneficialOwnersIndividualIdentification struct {
+	// A method that can be used to verify the individual's identity.
+	Method EntityCorporationBeneficialOwnersIndividualIdentificationMethod `json:"method" api:"required"`
+	// The last 4 digits of the identification number that can be used to verify the
+	// individual's identity.
+	NumberLast4 string                                                        `json:"number_last4" api:"required"`
+	ExtraFields map[string]interface{}                                        `json:"-" api:"extrafields"`
+	JSON        entityCorporationBeneficialOwnersIndividualIdentificationJSON `json:"-"`
+}
+
+// entityCorporationBeneficialOwnersIndividualIdentificationJSON contains the JSON
+// metadata for the struct
+// [EntityCorporationBeneficialOwnersIndividualIdentification]
+type entityCorporationBeneficialOwnersIndividualIdentificationJSON struct {
+	Method      apijson.Field
+	NumberLast4 apijson.Field
+	raw         string
+	ExtraFields map[string]apijson.Field
+}
+
+func (r *EntityCorporationBeneficialOwnersIndividualIdentification) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r entityCorporationBeneficialOwnersIndividualIdentificationJSON) RawJSON() string {
+	return r.raw
+}
+
+// A method that can be used to verify the individual's identity.
+type EntityCorporationBeneficialOwnersIndividualIdentificationMethod string
+
+const (
+	EntityCorporationBeneficialOwnersIndividualIdentificationMethodSocialSecurityNumber                   EntityCorporationBeneficialOwnersIndividualIdentificationMethod = "social_security_number"
+	EntityCorporationBeneficialOwnersIndividualIdentificationMethodIndividualTaxpayerIdentificationNumber EntityCorporationBeneficialOwnersIndividualIdentificationMethod = "individual_taxpayer_identification_number"
+	EntityCorporationBeneficialOwnersIndividualIdentificationMethodPassport                               EntityCorporationBeneficialOwnersIndividualIdentificationMethod = "passport"
+	EntityCorporationBeneficialOwnersIndividualIdentificationMethodDriversLicense                         EntityCorporationBeneficialOwnersIndividualIdentificationMethod = "drivers_license"
+	EntityCorporationBeneficialOwnersIndividualIdentificationMethodOther                                  EntityCorporationBeneficialOwnersIndividualIdentificationMethod = "other"
+)
+
+func (r EntityCorporationBeneficialOwnersIndividualIdentificationMethod) IsKnown() bool {
+	switch r {
+	case EntityCorporationBeneficialOwnersIndividualIdentificationMethodSocialSecurityNumber, EntityCorporationBeneficialOwnersIndividualIdentificationMethodIndividualTaxpayerIdentificationNumber, EntityCorporationBeneficialOwnersIndividualIdentificationMethodPassport, EntityCorporationBeneficialOwnersIndividualIdentificationMethodDriversLicense, EntityCorporationBeneficialOwnersIndividualIdentificationMethodOther:
+		return true
+	}
+	return false
+}
+
+type EntityCorporationBeneficialOwnersProng string
+
+const (
+	EntityCorporationBeneficialOwnersProngOwnership EntityCorporationBeneficialOwnersProng = "ownership"
+	EntityCorporationBeneficialOwnersProngControl   EntityCorporationBeneficialOwnersProng = "control"
+)
+
+func (r EntityCorporationBeneficialOwnersProng) IsKnown() bool {
+	switch r {
+	case EntityCorporationBeneficialOwnersProngOwnership, EntityCorporationBeneficialOwnersProngControl:
+		return true
+	}
+	return false
+}
+
 // Details of the government authority entity. Will be present if `structure` is
 // equal to `government_authority`.
 type EntityGovernmentAuthority struct {