paid-python 0.6.0__py3-none-any.whl → 1.0.0a1__py3-none-any.whl

paid/customers/client.py

@@ -5,13 +5,11 @@ import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
-from ..types.address import Address
-from ..types.cost_traces_response import CostTracesResponse
-from ..types.creation_source import CreationSource
 from ..types.customer import Customer
-from ..types.entitlement_usage import EntitlementUsage
-from ..types.tax_exempt_status import TaxExemptStatus
-from ..types.usage_summaries_response import UsageSummariesResponse
+from ..types.customer_billing_address import CustomerBillingAddress
+from ..types.customer_creation_state import CustomerCreationState
+from ..types.customer_list_response import CustomerListResponse
+from ..types.empty_response import EmptyResponse
 from .raw_client import AsyncRawCustomersClient, RawCustomersClient
 
 # this is used as the default value for optional parameters
@@ -33,17 +31,29 @@ class CustomersClient:
         """
         return self._raw_client
 
-    def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Customer]:
+    def list_customers(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CustomerListResponse:
         """
+        Get a list of customers for the organization
+
         Parameters
         ----------
+        limit : typing.Optional[int]
+
+        offset : typing.Optional[int]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        typing.List[Customer]
-            Success response
+        CustomerListResponse
+            200
 
         Examples
         --------
@@ -52,49 +62,50 @@ class CustomersClient:
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.list()
+        client.customers.list_customers()
         """
-        _response = self._raw_client.list(request_options=request_options)
+        _response = self._raw_client.list_customers(limit=limit, offset=offset, request_options=request_options)
         return _response.data
 
-    def create(
+    def create_a_new_customer(
         self,
         *,
         name: str,
-        external_id: typing.Optional[str] = OMIT,
+        legal_name: typing.Optional[str] = OMIT,
+        email: typing.Optional[str] = OMIT,
         phone: typing.Optional[str] = OMIT,
-        employee_count: typing.Optional[float] = OMIT,
-        annual_revenue: typing.Optional[float] = OMIT,
-        tax_exempt_status: typing.Optional[TaxExemptStatus] = OMIT,
-        creation_source: typing.Optional[CreationSource] = OMIT,
         website: typing.Optional[str] = OMIT,
-        billing_address: typing.Optional[Address] = OMIT,
+        external_id: typing.Optional[str] = OMIT,
+        billing_address: typing.Optional[CustomerBillingAddress] = OMIT,
+        creation_state: typing.Optional[CustomerCreationState] = OMIT,
+        vat_number: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Customer:
         """
+        Creates a new customer for the organization
+
         Parameters
         ----------
         name : str
 
-        external_id : typing.Optional[str]
+        legal_name : typing.Optional[str]
 
-        phone : typing.Optional[str]
+        email : typing.Optional[str]
 
-        employee_count : typing.Optional[float]
+        phone : typing.Optional[str]
 
-        annual_revenue : typing.Optional[float]
+        website : typing.Optional[str]
 
-        tax_exempt_status : typing.Optional[TaxExemptStatus]
+        external_id : typing.Optional[str]
 
-        creation_source : typing.Optional[CreationSource]
+        billing_address : typing.Optional[CustomerBillingAddress]
 
-        website : typing.Optional[str]
+        creation_state : typing.Optional[CustomerCreationState]
 
-        billing_address : typing.Optional[Address]
+        vat_number : typing.Optional[str]
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
-            Flexible JSON field for storing custom metadata about the customer
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -102,7 +113,7 @@ class CustomersClient:
         Returns
         -------
         Customer
-            Success response
+            201
 
         Examples
         --------
@@ -111,31 +122,32 @@ class CustomersClient:
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.create(
-            name="Acme, Inc.",
-            external_id="acme-inc",
+        client.customers.create_a_new_customer(
+            name="name",
         )
         """
-        _response = self._raw_client.create(
+        _response = self._raw_client.create_a_new_customer(
             name=name,
-            external_id=external_id,
+            legal_name=legal_name,
+            email=email,
             phone=phone,
-            employee_count=employee_count,
-            annual_revenue=annual_revenue,
-            tax_exempt_status=tax_exempt_status,
-            creation_source=creation_source,
             website=website,
+            external_id=external_id,
             billing_address=billing_address,
+            creation_state=creation_state,
+            vat_number=vat_number,
             metadata=metadata,
             request_options=request_options,
         )
         return _response.data
 
-    def get(self, customer_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Customer:
+    def get_customer(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Customer:
         """
+        Get a customer by its ID
+
         Parameters
         ----------
-        customer_id : str
+        id : str
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -143,7 +155,7 @@ class CustomersClient:
         Returns
         -------
         Customer
-            Success response
+            200
 
         Examples
         --------
@@ -152,54 +164,58 @@ class CustomersClient:
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.get(
-            customer_id="customerId",
+        client.customers.get_customer(
+            id="id",
         )
         """
-        _response = self._raw_client.get(customer_id, request_options=request_options)
+        _response = self._raw_client.get_customer(id, request_options=request_options)
         return _response.data
 
-    def update(
+    def update_customer(
         self,
-        customer_id: str,
+        id: str,
         *,
         name: typing.Optional[str] = OMIT,
-        external_id: typing.Optional[str] = OMIT,
+        legal_name: typing.Optional[str] = OMIT,
+        email: typing.Optional[str] = OMIT,
         phone: typing.Optional[str] = OMIT,
-        employee_count: typing.Optional[float] = OMIT,
-        annual_revenue: typing.Optional[float] = OMIT,
-        tax_exempt_status: typing.Optional[TaxExemptStatus] = OMIT,
-        creation_source: typing.Optional[CreationSource] = OMIT,
         website: typing.Optional[str] = OMIT,
-        billing_address: typing.Optional[Address] = OMIT,
+        external_id: typing.Optional[str] = OMIT,
+        billing_address: typing.Optional[CustomerBillingAddress] = OMIT,
+        creation_state: typing.Optional[CustomerCreationState] = OMIT,
+        churn_date: typing.Optional[dt.datetime] = OMIT,
+        vat_number: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Customer:
         """
+        Update a customer by its ID
+
         Parameters
         ----------
-        customer_id : str
+        id : str
 
         name : typing.Optional[str]
 
-        external_id : typing.Optional[str]
+        legal_name : typing.Optional[str]
+
+        email : typing.Optional[str]
 
         phone : typing.Optional[str]
 
-        employee_count : typing.Optional[float]
+        website : typing.Optional[str]
 
-        annual_revenue : typing.Optional[float]
+        external_id : typing.Optional[str]
 
-        tax_exempt_status : typing.Optional[TaxExemptStatus]
+        billing_address : typing.Optional[CustomerBillingAddress]
 
-        creation_source : typing.Optional[CreationSource]
+        creation_state : typing.Optional[CustomerCreationState]
 
-        website : typing.Optional[str]
+        churn_date : typing.Optional[dt.datetime]
 
-        billing_address : typing.Optional[Address]
+        vat_number : typing.Optional[str]
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
-            Flexible JSON field for storing custom metadata about the customer
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -207,7 +223,7 @@ class CustomersClient:
         Returns
         -------
         Customer
-            Customer updated successfully
+            200
 
         Examples
         --------
@@ -216,73 +232,42 @@ class CustomersClient:
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.update(
-            customer_id="customerId",
-            name="Acme, Inc. (Updated)",
-            phone="123-456-7890",
-            employee_count=101.0,
-            annual_revenue=1000001.0,
+        client.customers.update_customer(
+            id="id",
         )
         """
-        _response = self._raw_client.update(
-            customer_id,
+        _response = self._raw_client.update_customer(
+            id,
             name=name,
-            external_id=external_id,
+            legal_name=legal_name,
+            email=email,
             phone=phone,
-            employee_count=employee_count,
-            annual_revenue=annual_revenue,
-            tax_exempt_status=tax_exempt_status,
-            creation_source=creation_source,
             website=website,
+            external_id=external_id,
             billing_address=billing_address,
+            creation_state=creation_state,
+            churn_date=churn_date,
+            vat_number=vat_number,
             metadata=metadata,
             request_options=request_options,
         )
         return _response.data
 
-    def delete(self, customer_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        customer_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from paid import Paid
-
-        client = Paid(
-            token="YOUR_TOKEN",
-        )
-        client.customers.delete(
-            customer_id="customerId",
-        )
+    def delete_customer(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> EmptyResponse:
         """
-        _response = self._raw_client.delete(customer_id, request_options=request_options)
-        return _response.data
+        Delete a customer by its ID
 
-    def get_entitlements(
-        self, customer_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[EntitlementUsage]:
-        """
         Parameters
         ----------
-        customer_id : str
-            The customer ID
+        id : str
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        typing.List[EntitlementUsage]
-            Success response
+        EmptyResponse
+            200
 
         Examples
         --------
@@ -291,17 +276,19 @@ class CustomersClient:
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.get_entitlements(
-            customer_id="customerId",
+        client.customers.delete_customer(
+            id="id",
         )
         """
-        _response = self._raw_client.get_entitlements(customer_id, request_options=request_options)
+        _response = self._raw_client.delete_customer(id, request_options=request_options)
         return _response.data
 
-    def get_by_external_id(
+    def get_customer_by_external_id(
         self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> Customer:
         """
+        Get a customer by its externalId
+
         Parameters
         ----------
         external_id : str
@@ -312,7 +299,7 @@ class CustomersClient:
         Returns
         -------
         Customer
-            Success response
+            200
 
         Examples
         --------
@@ -321,54 +308,58 @@ class CustomersClient:
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.get_by_external_id(
+        client.customers.get_customer_by_external_id(
             external_id="externalId",
         )
         """
-        _response = self._raw_client.get_by_external_id(external_id, request_options=request_options)
+        _response = self._raw_client.get_customer_by_external_id(external_id, request_options=request_options)
         return _response.data
 
-    def update_by_external_id(
+    def update_customer_by_external_id(
         self,
         external_id_: str,
         *,
         name: typing.Optional[str] = OMIT,
-        external_id: typing.Optional[str] = OMIT,
+        legal_name: typing.Optional[str] = OMIT,
+        email: typing.Optional[str] = OMIT,
         phone: typing.Optional[str] = OMIT,
-        employee_count: typing.Optional[float] = OMIT,
-        annual_revenue: typing.Optional[float] = OMIT,
-        tax_exempt_status: typing.Optional[TaxExemptStatus] = OMIT,
-        creation_source: typing.Optional[CreationSource] = OMIT,
         website: typing.Optional[str] = OMIT,
-        billing_address: typing.Optional[Address] = OMIT,
+        external_id: typing.Optional[str] = OMIT,
+        billing_address: typing.Optional[CustomerBillingAddress] = OMIT,
+        creation_state: typing.Optional[CustomerCreationState] = OMIT,
+        churn_date: typing.Optional[dt.datetime] = OMIT,
+        vat_number: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Customer:
         """
+        Update a customer by its externalId
+
         Parameters
         ----------
         external_id_ : str
 
         name : typing.Optional[str]
 
-        external_id : typing.Optional[str]
+        legal_name : typing.Optional[str]
+
+        email : typing.Optional[str]
 
         phone : typing.Optional[str]
 
-        employee_count : typing.Optional[float]
+        website : typing.Optional[str]
 
-        annual_revenue : typing.Optional[float]
+        external_id : typing.Optional[str]
 
-        tax_exempt_status : typing.Optional[TaxExemptStatus]
+        billing_address : typing.Optional[CustomerBillingAddress]
 
-        creation_source : typing.Optional[CreationSource]
+        creation_state : typing.Optional[CustomerCreationState]
 
-        website : typing.Optional[str]
+        churn_date : typing.Optional[dt.datetime]
 
-        billing_address : typing.Optional[Address]
+        vat_number : typing.Optional[str]
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
-            Flexible JSON field for storing custom metadata about the customer
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -376,7 +367,7 @@ class CustomersClient:
         Returns
         -------
         Customer
-            Success response
+            200
 
         Examples
         --------
@@ -385,187 +376,57 @@ class CustomersClient:
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.update_by_external_id(
+        client.customers.update_customer_by_external_id(
             external_id_="externalId",
         )
         """
-        _response = self._raw_client.update_by_external_id(
+        _response = self._raw_client.update_customer_by_external_id(
             external_id_,
             name=name,
-            external_id=external_id,
+            legal_name=legal_name,
+            email=email,
             phone=phone,
-            employee_count=employee_count,
-            annual_revenue=annual_revenue,
-            tax_exempt_status=tax_exempt_status,
-            creation_source=creation_source,
             website=website,
+            external_id=external_id,
             billing_address=billing_address,
+            creation_state=creation_state,
+            churn_date=churn_date,
+            vat_number=vat_number,
             metadata=metadata,
             request_options=request_options,
         )
         return _response.data
 
-    def delete_by_external_id(
+    def delete_customer_by_external_id(
         self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> None:
+    ) -> EmptyResponse:
         """
-        Parameters
-        ----------
-        external_id : str
+        Delete a customer by its externalId
 
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from paid import Paid
-
-        client = Paid(
-            token="YOUR_TOKEN",
-        )
-        client.customers.delete_by_external_id(
-            external_id="externalId",
-        )
-        """
-        _response = self._raw_client.delete_by_external_id(external_id, request_options=request_options)
-        return _response.data
-
-    def get_costs_by_external_id(
-        self,
-        external_id: str,
-        *,
-        limit: typing.Optional[int] = None,
-        offset: typing.Optional[int] = None,
-        start_time: typing.Optional[dt.datetime] = None,
-        end_time: typing.Optional[dt.datetime] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> CostTracesResponse:
-        """
         Parameters
         ----------
         external_id : str
-            The external ID of the customer
-
-        limit : typing.Optional[int]
-            Maximum number of traces to return (1-1000)
-
-        offset : typing.Optional[int]
-            Number of traces to skip for pagination
-
-        start_time : typing.Optional[dt.datetime]
-            Filter traces starting from this time (ISO 8601 format)
-
-        end_time : typing.Optional[dt.datetime]
-            Filter traces up to this time (ISO 8601 format)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        CostTracesResponse
-            Success response
+        EmptyResponse
+            200
 
         Examples
         --------
-        import datetime
-
         from paid import Paid
 
         client = Paid(
             token="YOUR_TOKEN",
         )
-        client.customers.get_costs_by_external_id(
+        client.customers.delete_customer_by_external_id(
             external_id="externalId",
-            limit=1,
-            offset=1,
-            start_time=datetime.datetime.fromisoformat(
-                "2024-01-15 09:30:00+00:00",
-            ),
-            end_time=datetime.datetime.fromisoformat(
-                "2024-01-15 09:30:00+00:00",
-            ),
         )
         """
-        _response = self._raw_client.get_costs_by_external_id(
-            external_id,
-            limit=limit,
-            offset=offset,
-            start_time=start_time,
-            end_time=end_time,
-            request_options=request_options,
-        )
-        return _response.data
-
-    def get_usage_by_external_id(
-        self,
-        external_id: str,
-        *,
-        limit: typing.Optional[int] = None,
-        offset: typing.Optional[int] = None,
-        start_time: typing.Optional[dt.datetime] = None,
-        end_time: typing.Optional[dt.datetime] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> UsageSummariesResponse:
-        """
-        Parameters
-        ----------
-        external_id : str
-            The external ID of the customer
-
-        limit : typing.Optional[int]
-            Maximum number of usage summaries to return (1-1000)
-
-        offset : typing.Optional[int]
-            Number of usage summaries to skip for pagination
-
-        start_time : typing.Optional[dt.datetime]
-            Filter usage summaries starting from this time (ISO 8601 format). Returns summaries that overlap with the time range.
-
-        end_time : typing.Optional[dt.datetime]
-            Filter usage summaries up to this time (ISO 8601 format). Returns summaries that overlap with the time range.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        UsageSummariesResponse
-            Success response
-
-        Examples
-        --------
-        import datetime
-
-        from paid import Paid
-
-        client = Paid(
-            token="YOUR_TOKEN",
-        )
-        client.customers.get_usage_by_external_id(
-            external_id="externalId",
-            limit=1,
-            offset=1,
-            start_time=datetime.datetime.fromisoformat(
-                "2024-01-15 09:30:00+00:00",
-            ),
-            end_time=datetime.datetime.fromisoformat(
-                "2024-01-15 09:30:00+00:00",
-            ),
-        )
-        """
-        _response = self._raw_client.get_usage_by_external_id(
-            external_id,
-            limit=limit,
-            offset=offset,
-            start_time=start_time,
-            end_time=end_time,
-            request_options=request_options,
-        )
+        _response = self._raw_client.delete_customer_by_external_id(external_id, request_options=request_options)
         return _response.data
 
 
@@ -584,17 +445,29 @@ class AsyncCustomersClient:
         """
         return self._raw_client
 
-    async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Customer]:
+    async def list_customers(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CustomerListResponse:
         """
+        Get a list of customers for the organization
+
         Parameters
         ----------
+        limit : typing.Optional[int]
+
+        offset : typing.Optional[int]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        typing.List[Customer]
-            Success response
+        CustomerListResponse
+            200
 
         Examples
         --------
@@ -608,52 +481,53 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.list()
+            await client.customers.list_customers()
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(request_options=request_options)
+        _response = await self._raw_client.list_customers(limit=limit, offset=offset, request_options=request_options)
         return _response.data
 
-    async def create(
+    async def create_a_new_customer(
         self,
         *,
         name: str,
-        external_id: typing.Optional[str] = OMIT,
+        legal_name: typing.Optional[str] = OMIT,
+        email: typing.Optional[str] = OMIT,
         phone: typing.Optional[str] = OMIT,
-        employee_count: typing.Optional[float] = OMIT,
-        annual_revenue: typing.Optional[float] = OMIT,
-        tax_exempt_status: typing.Optional[TaxExemptStatus] = OMIT,
-        creation_source: typing.Optional[CreationSource] = OMIT,
         website: typing.Optional[str] = OMIT,
-        billing_address: typing.Optional[Address] = OMIT,
+        external_id: typing.Optional[str] = OMIT,
+        billing_address: typing.Optional[CustomerBillingAddress] = OMIT,
+        creation_state: typing.Optional[CustomerCreationState] = OMIT,
+        vat_number: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Customer:
         """
+        Creates a new customer for the organization
+
         Parameters
         ----------
         name : str
 
-        external_id : typing.Optional[str]
+        legal_name : typing.Optional[str]
 
-        phone : typing.Optional[str]
+        email : typing.Optional[str]
 
-        employee_count : typing.Optional[float]
+        phone : typing.Optional[str]
 
-        annual_revenue : typing.Optional[float]
+        website : typing.Optional[str]
 
-        tax_exempt_status : typing.Optional[TaxExemptStatus]
+        external_id : typing.Optional[str]
 
-        creation_source : typing.Optional[CreationSource]
+        billing_address : typing.Optional[CustomerBillingAddress]
 
-        website : typing.Optional[str]
+        creation_state : typing.Optional[CustomerCreationState]
 
-        billing_address : typing.Optional[Address]
+        vat_number : typing.Optional[str]
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
-            Flexible JSON field for storing custom metadata about the customer
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -661,7 +535,7 @@ class AsyncCustomersClient:
         Returns
         -------
         Customer
-            Success response
+            201
 
         Examples
         --------
@@ -675,34 +549,35 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.create(
-                name="Acme, Inc.",
-                external_id="acme-inc",
+            await client.customers.create_a_new_customer(
+                name="name",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.create(
+        _response = await self._raw_client.create_a_new_customer(
             name=name,
-            external_id=external_id,
+            legal_name=legal_name,
+            email=email,
             phone=phone,
-            employee_count=employee_count,
-            annual_revenue=annual_revenue,
-            tax_exempt_status=tax_exempt_status,
-            creation_source=creation_source,
             website=website,
+            external_id=external_id,
             billing_address=billing_address,
+            creation_state=creation_state,
+            vat_number=vat_number,
             metadata=metadata,
             request_options=request_options,
         )
         return _response.data
 
-    async def get(self, customer_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Customer:
+    async def get_customer(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Customer:
         """
+        Get a customer by its ID
+
         Parameters
         ----------
-        customer_id : str
+        id : str
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -710,7 +585,7 @@ class AsyncCustomersClient:
         Returns
         -------
         Customer
-            Success response
+            200
 
         Examples
         --------
@@ -724,57 +599,61 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.get(
-                customer_id="customerId",
+            await client.customers.get_customer(
+                id="id",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get(customer_id, request_options=request_options)
+        _response = await self._raw_client.get_customer(id, request_options=request_options)
         return _response.data
 
-    async def update(
+    async def update_customer(
         self,
-        customer_id: str,
+        id: str,
         *,
         name: typing.Optional[str] = OMIT,
-        external_id: typing.Optional[str] = OMIT,
+        legal_name: typing.Optional[str] = OMIT,
+        email: typing.Optional[str] = OMIT,
         phone: typing.Optional[str] = OMIT,
-        employee_count: typing.Optional[float] = OMIT,
-        annual_revenue: typing.Optional[float] = OMIT,
-        tax_exempt_status: typing.Optional[TaxExemptStatus] = OMIT,
-        creation_source: typing.Optional[CreationSource] = OMIT,
         website: typing.Optional[str] = OMIT,
-        billing_address: typing.Optional[Address] = OMIT,
+        external_id: typing.Optional[str] = OMIT,
+        billing_address: typing.Optional[CustomerBillingAddress] = OMIT,
+        creation_state: typing.Optional[CustomerCreationState] = OMIT,
+        churn_date: typing.Optional[dt.datetime] = OMIT,
+        vat_number: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Customer:
         """
+        Update a customer by its ID
+
         Parameters
         ----------
-        customer_id : str
+        id : str
 
         name : typing.Optional[str]
 
-        external_id : typing.Optional[str]
+        legal_name : typing.Optional[str]
+
+        email : typing.Optional[str]
 
         phone : typing.Optional[str]
 
-        employee_count : typing.Optional[float]
+        website : typing.Optional[str]
 
-        annual_revenue : typing.Optional[float]
+        external_id : typing.Optional[str]
 
-        tax_exempt_status : typing.Optional[TaxExemptStatus]
+        billing_address : typing.Optional[CustomerBillingAddress]
 
-        creation_source : typing.Optional[CreationSource]
+        creation_state : typing.Optional[CustomerCreationState]
 
-        website : typing.Optional[str]
+        churn_date : typing.Optional[dt.datetime]
 
-        billing_address : typing.Optional[Address]
+        vat_number : typing.Optional[str]
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
-            Flexible JSON field for storing custom metadata about the customer
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -782,7 +661,7 @@ class AsyncCustomersClient:
         Returns
         -------
         Customer
-            Customer updated successfully
+            200
 
         Examples
         --------
@@ -796,84 +675,47 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.update(
-                customer_id="customerId",
-                name="Acme, Inc. (Updated)",
-                phone="123-456-7890",
-                employee_count=101.0,
-                annual_revenue=1000001.0,
+            await client.customers.update_customer(
+                id="id",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.update(
-            customer_id,
+        _response = await self._raw_client.update_customer(
+            id,
             name=name,
-            external_id=external_id,
+            legal_name=legal_name,
+            email=email,
             phone=phone,
-            employee_count=employee_count,
-            annual_revenue=annual_revenue,
-            tax_exempt_status=tax_exempt_status,
-            creation_source=creation_source,
             website=website,
+            external_id=external_id,
             billing_address=billing_address,
+            creation_state=creation_state,
+            churn_date=churn_date,
+            vat_number=vat_number,
             metadata=metadata,
             request_options=request_options,
         )
         return _response.data
 
-    async def delete(self, customer_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        customer_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        import asyncio
-
-        from paid import AsyncPaid
-
-        client = AsyncPaid(
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.customers.delete(
-                customer_id="customerId",
-            )
-
-
-        asyncio.run(main())
+    async def delete_customer(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> EmptyResponse:
         """
-        _response = await self._raw_client.delete(customer_id, request_options=request_options)
-        return _response.data
+        Delete a customer by its ID
 
-    async def get_entitlements(
-        self, customer_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[EntitlementUsage]:
-        """
         Parameters
         ----------
-        customer_id : str
-            The customer ID
+        id : str
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        typing.List[EntitlementUsage]
-            Success response
+        EmptyResponse
+            200
 
         Examples
         --------
@@ -887,20 +729,22 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.get_entitlements(
-                customer_id="customerId",
+            await client.customers.delete_customer(
+                id="id",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get_entitlements(customer_id, request_options=request_options)
+        _response = await self._raw_client.delete_customer(id, request_options=request_options)
         return _response.data
 
-    async def get_by_external_id(
+    async def get_customer_by_external_id(
         self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> Customer:
         """
+        Get a customer by its externalId
+
         Parameters
         ----------
         external_id : str
@@ -911,7 +755,7 @@ class AsyncCustomersClient:
         Returns
         -------
         Customer
-            Success response
+            200
 
         Examples
         --------
@@ -925,57 +769,61 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.get_by_external_id(
+            await client.customers.get_customer_by_external_id(
                 external_id="externalId",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get_by_external_id(external_id, request_options=request_options)
+        _response = await self._raw_client.get_customer_by_external_id(external_id, request_options=request_options)
         return _response.data
 
-    async def update_by_external_id(
+    async def update_customer_by_external_id(
         self,
         external_id_: str,
         *,
         name: typing.Optional[str] = OMIT,
-        external_id: typing.Optional[str] = OMIT,
+        legal_name: typing.Optional[str] = OMIT,
+        email: typing.Optional[str] = OMIT,
         phone: typing.Optional[str] = OMIT,
-        employee_count: typing.Optional[float] = OMIT,
-        annual_revenue: typing.Optional[float] = OMIT,
-        tax_exempt_status: typing.Optional[TaxExemptStatus] = OMIT,
-        creation_source: typing.Optional[CreationSource] = OMIT,
         website: typing.Optional[str] = OMIT,
-        billing_address: typing.Optional[Address] = OMIT,
+        external_id: typing.Optional[str] = OMIT,
+        billing_address: typing.Optional[CustomerBillingAddress] = OMIT,
+        creation_state: typing.Optional[CustomerCreationState] = OMIT,
+        churn_date: typing.Optional[dt.datetime] = OMIT,
+        vat_number: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Customer:
         """
+        Update a customer by its externalId
+
         Parameters
         ----------
         external_id_ : str
 
         name : typing.Optional[str]
 
-        external_id : typing.Optional[str]
+        legal_name : typing.Optional[str]
+
+        email : typing.Optional[str]
 
         phone : typing.Optional[str]
 
-        employee_count : typing.Optional[float]
+        website : typing.Optional[str]
 
-        annual_revenue : typing.Optional[float]
+        external_id : typing.Optional[str]
 
-        tax_exempt_status : typing.Optional[TaxExemptStatus]
+        billing_address : typing.Optional[CustomerBillingAddress]
 
-        creation_source : typing.Optional[CreationSource]
+        creation_state : typing.Optional[CustomerCreationState]
 
-        website : typing.Optional[str]
+        churn_date : typing.Optional[dt.datetime]
 
-        billing_address : typing.Optional[Address]
+        vat_number : typing.Optional[str]
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
-            Flexible JSON field for storing custom metadata about the customer
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -983,7 +831,7 @@ class AsyncCustomersClient:
         Returns
         -------
         Customer
-            Success response
+            200
 
         Examples
         --------
@@ -997,106 +845,51 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.update_by_external_id(
+            await client.customers.update_customer_by_external_id(
                 external_id_="externalId",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.update_by_external_id(
+        _response = await self._raw_client.update_customer_by_external_id(
             external_id_,
             name=name,
-            external_id=external_id,
+            legal_name=legal_name,
+            email=email,
             phone=phone,
-            employee_count=employee_count,
-            annual_revenue=annual_revenue,
-            tax_exempt_status=tax_exempt_status,
-            creation_source=creation_source,
             website=website,
+            external_id=external_id,
             billing_address=billing_address,
+            creation_state=creation_state,
+            churn_date=churn_date,
+            vat_number=vat_number,
             metadata=metadata,
             request_options=request_options,
         )
         return _response.data
 
-    async def delete_by_external_id(
+    async def delete_customer_by_external_id(
         self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> None:
+    ) -> EmptyResponse:
         """
-        Parameters
-        ----------
-        external_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
+        Delete a customer by its externalId
 
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        import asyncio
-
-        from paid import AsyncPaid
-
-        client = AsyncPaid(
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.customers.delete_by_external_id(
-                external_id="externalId",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.delete_by_external_id(external_id, request_options=request_options)
-        return _response.data
-
-    async def get_costs_by_external_id(
-        self,
-        external_id: str,
-        *,
-        limit: typing.Optional[int] = None,
-        offset: typing.Optional[int] = None,
-        start_time: typing.Optional[dt.datetime] = None,
-        end_time: typing.Optional[dt.datetime] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> CostTracesResponse:
-        """
         Parameters
         ----------
         external_id : str
-            The external ID of the customer
-
-        limit : typing.Optional[int]
-            Maximum number of traces to return (1-1000)
-
-        offset : typing.Optional[int]
-            Number of traces to skip for pagination
-
-        start_time : typing.Optional[dt.datetime]
-            Filter traces starting from this time (ISO 8601 format)
-
-        end_time : typing.Optional[dt.datetime]
-            Filter traces up to this time (ISO 8601 format)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        CostTracesResponse
-            Success response
+        EmptyResponse
+            200
 
         Examples
         --------
         import asyncio
-        import datetime
 
         from paid import AsyncPaid
 
@@ -1106,101 +899,12 @@ class AsyncCustomersClient:
 
 
         async def main() -> None:
-            await client.customers.get_costs_by_external_id(
+            await client.customers.delete_customer_by_external_id(
                 external_id="externalId",
-                limit=1,
-                offset=1,
-                start_time=datetime.datetime.fromisoformat(
-                    "2024-01-15 09:30:00+00:00",
-                ),
-                end_time=datetime.datetime.fromisoformat(
-                    "2024-01-15 09:30:00+00:00",
-                ),
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get_costs_by_external_id(
-            external_id,
-            limit=limit,
-            offset=offset,
-            start_time=start_time,
-            end_time=end_time,
-            request_options=request_options,
-        )
-        return _response.data
-
-    async def get_usage_by_external_id(
-        self,
-        external_id: str,
-        *,
-        limit: typing.Optional[int] = None,
-        offset: typing.Optional[int] = None,
-        start_time: typing.Optional[dt.datetime] = None,
-        end_time: typing.Optional[dt.datetime] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> UsageSummariesResponse:
-        """
-        Parameters
-        ----------
-        external_id : str
-            The external ID of the customer
-
-        limit : typing.Optional[int]
-            Maximum number of usage summaries to return (1-1000)
-
-        offset : typing.Optional[int]
-            Number of usage summaries to skip for pagination
-
-        start_time : typing.Optional[dt.datetime]
-            Filter usage summaries starting from this time (ISO 8601 format). Returns summaries that overlap with the time range.
-
-        end_time : typing.Optional[dt.datetime]
-            Filter usage summaries up to this time (ISO 8601 format). Returns summaries that overlap with the time range.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        UsageSummariesResponse
-            Success response
-
-        Examples
-        --------
-        import asyncio
-        import datetime
-
-        from paid import AsyncPaid
-
-        client = AsyncPaid(
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.customers.get_usage_by_external_id(
-                external_id="externalId",
-                limit=1,
-                offset=1,
-                start_time=datetime.datetime.fromisoformat(
-                    "2024-01-15 09:30:00+00:00",
-                ),
-                end_time=datetime.datetime.fromisoformat(
-                    "2024-01-15 09:30:00+00:00",
-                ),
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.get_usage_by_external_id(
-            external_id,
-            limit=limit,
-            offset=offset,
-            start_time=start_time,
-            end_time=end_time,
-            request_options=request_options,
-        )
+        _response = await self._raw_client.delete_customer_by_external_id(external_id, request_options=request_options)
         return _response.data