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-6d31504be6985a7ded14abd0da36f4272e585f43332b4b844a6950c98ddcd525.yml
-openapi_spec_hash: f1a49121780ec8b6678b864ac9b1deca
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-e2a6ff4685a5e09babcce1fb8bac1f373d707d5b5aa82aae375d923de890e56e.yml
+openapi_spec_hash: 244249a4dfb6c746c161a704764d7630
 config_hash: 0997ade8b52ec04e82d5b0c3b61bb51e

src/increase/types/entity.py

@@ -17,6 +17,7 @@
     "CorporationBeneficialOwnerIndividual",
     "CorporationBeneficialOwnerIndividualAddress",
     "CorporationBeneficialOwnerIndividualIdentification",
+    "CorporationLegalIdentifier",
     "GovernmentAuthority",
     "GovernmentAuthorityAddress",
     "GovernmentAuthorityAuthorizedPerson",
@@ -172,6 +173,22 @@ def __getattr__(self, attr: str) -> object: ...
         __pydantic_extra__: Dict[str, object]
 
 
+class CorporationLegalIdentifier(BaseModel):
+    """The legal identifier of the corporation."""
+
+    category: Literal["us_employer_identification_number", "other"]
+    """The category of the legal identifier.
+
+    - `us_employer_identification_number` - The Employer Identification Number (EIN)
+      for the company. The EIN is a 9-digit number assigned by the IRS.
+    - `other` - A legal identifier issued by a foreign government, like a tax
+      identification number or registration number.
+    """
+
+    value: str
+    """The identifier of the legal identifier."""
+
+
 class Corporation(BaseModel):
     """Details of the corporation entity.
 
@@ -202,15 +219,27 @@ class Corporation(BaseModel):
     for the corporation.
     """
 
+    legal_identifier: Optional[CorporationLegalIdentifier] = None
+    """The legal identifier of the corporation."""
+
     name: str
     """The legal name of the corporation."""
 
-    tax_identifier: Optional[str] = None
-    """The Employer Identification Number (EIN) for the corporation."""
-
     website: Optional[str] = None
     """The website of the corporation."""
 
+    if TYPE_CHECKING:
+        # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a
+        # value to this field, so for compatibility we avoid doing it at runtime.
+        __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
+
+        # Stub to indicate that arbitrary properties are accepted.
+        # To access properties that are not valid identifiers you can use `getattr`, e.g.
+        # `getattr(obj, '$type')`
+        def __getattr__(self, attr: str) -> object: ...
+    else:
+        __pydantic_extra__: Dict[str, object]
+
 
 class GovernmentAuthorityAddress(BaseModel):
     """The government authority's address."""

src/increase/types/entity_create_params.py

@@ -19,6 +19,7 @@
     "CorporationBeneficialOwnerIndividualIdentificationDriversLicense",
     "CorporationBeneficialOwnerIndividualIdentificationOther",
     "CorporationBeneficialOwnerIndividualIdentificationPassport",
+    "CorporationLegalIdentifier",
     "GovernmentAuthority",
     "GovernmentAuthorityAddress",
     "GovernmentAuthorityAuthorizedPerson",
@@ -334,7 +335,28 @@ class CorporationBeneficialOwner(TypedDict, total=False, extra_items=object):  #
     """This person's role or title within the entity."""
 
 
-class Corporation(TypedDict, total=False):
+class CorporationLegalIdentifier(TypedDict, total=False):
+    """The legal identifier of the corporation.
+
+    This is usually the Employer Identification Number (EIN).
+    """
+
+    value: Required[str]
+    """The legal identifier."""
+
+    category: Literal["us_employer_identification_number", "other"]
+    """The category of the legal identifier.
+
+    If not provided, the default is `us_employer_identification_number`.
+
+    - `us_employer_identification_number` - The Employer Identification Number (EIN)
+      for the company. The EIN is a 9-digit number assigned by the IRS.
+    - `other` - A legal identifier issued by a foreign government, like a tax
+      identification number or registration number.
+    """
+
+
+class Corporation(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
     """Details of the corporation entity to create.
 
     Required if `structure` is equal to `corporation`.
@@ -353,12 +375,15 @@ class Corporation(TypedDict, total=False):
     between 1 and 5 people to this list.
     """
 
+    legal_identifier: Required[CorporationLegalIdentifier]
+    """The legal identifier of the corporation.
+
+    This is usually the Employer Identification Number (EIN).
+    """
+
     name: Required[str]
     """The legal name of the corporation."""
 
-    tax_identifier: Required[str]
-    """The Employer Identification Number (EIN) for the corporation."""
-
     beneficial_ownership_exemption_reason: Literal[
         "regulated_financial_institution", "publicly_traded_company", "public_entity", "other"
     ]

tests/api_resources/test_entities.py

@@ -79,8 +79,11 @@ def test_method_create_with_all_params(self, client: Increase) -> None:
                         "company_title": "CEO",
                     }
                 ],
+                "legal_identifier": {
+                    "value": "602214076",
+                    "category": "us_employer_identification_number",
+                },
                 "name": "National Phonograph Company",
-                "tax_identifier": "602214076",
                 "beneficial_ownership_exemption_reason": "regulated_financial_institution",
                 "email": "dev@stainless.com",
                 "incorporation_state": "NY",
@@ -585,8 +588,11 @@ async def test_method_create_with_all_params(self, async_client: AsyncIncrease)
                         "company_title": "CEO",
                     }
                 ],
+                "legal_identifier": {
+                    "value": "602214076",
+                    "category": "us_employer_identification_number",
+                },
                 "name": "National Phonograph Company",
-                "tax_identifier": "602214076",
                 "beneficial_ownership_exemption_reason": "regulated_financial_institution",
                 "email": "dev@stainless.com",
                 "incorporation_state": "NY",