moolabs 0.3.0__py3-none-any.whl

moolabs/api/meters_api.py

@@ -0,0 +1,3707 @@
+# coding: utf-8
+
+"""
+    Moolabs API
+
+    Unified Moolabs SDK. Capability-based public surface stitched from internal service specs: bff, meter, arc, acute. Customers see capability namespaces (usage, billing, collections, etc.); the SDK routes per-operation internally.
+
+    The version of the OpenAPI document: 0.3.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+import warnings
+from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
+from typing import Any, Dict, List, Optional, Tuple, Union
+from typing_extensions import Annotated
+
+from datetime import datetime
+from pydantic import Field, StrictBool, StrictStr, field_validator
+from typing import Dict, List, Optional
+from typing_extensions import Annotated
+from moolabs.models.filter_string import FilterString
+from moolabs.models.meter import Meter
+from moolabs.models.meter_create import MeterCreate
+from moolabs.models.meter_order_by import MeterOrderBy
+from moolabs.models.meter_query_request import MeterQueryRequest
+from moolabs.models.meter_query_result import MeterQueryResult
+from moolabs.models.meter_test_event_request import MeterTestEventRequest
+from moolabs.models.meter_test_event_response import MeterTestEventResponse
+from moolabs.models.meter_update import MeterUpdate
+from moolabs.models.meter_usage_summary_response import MeterUsageSummaryResponse
+from moolabs.models.sort_order import SortOrder
+from moolabs.models.usage_summary_window_size import UsageSummaryWindowSize
+from moolabs.models.window_size import WindowSize
+
+from moolabs.api_client import ApiClient, RequestSerialized
+from moolabs.api_response import ApiResponse
+from moolabs.rest import RESTResponseType
+
+
+class MetersApi:
+    """NOTE: This class is auto generated by OpenAPI Generator
+    Ref: https://openapi-generator.tech
+
+    Do not edit the class manually.
+    """
+
+    def __init__(self, api_client=None) -> None:
+        if api_client is None:
+            api_client = ApiClient.get_default()
+        self.api_client = api_client
+
+
+    @validate_call
+    def create_meter(
+        self,
+        meter_create: MeterCreate,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> Meter:
+        """Create meter
+
+        Create a meter.
+
+        :param meter_create: (required)
+        :type meter_create: MeterCreate
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._create_meter_serialize(
+            meter_create=meter_create,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '201': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def create_meter_with_http_info(
+        self,
+        meter_create: MeterCreate,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[Meter]:
+        """Create meter
+
+        Create a meter.
+
+        :param meter_create: (required)
+        :type meter_create: MeterCreate
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._create_meter_serialize(
+            meter_create=meter_create,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '201': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def create_meter_without_preload_content(
+        self,
+        meter_create: MeterCreate,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Create meter
+
+        Create a meter.
+
+        :param meter_create: (required)
+        :type meter_create: MeterCreate
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._create_meter_serialize(
+            meter_create=meter_create,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '201': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _create_meter_serialize(
+        self,
+        meter_create,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if meter_create is not None:
+            _body_params = meter_create
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='POST',
+            resource_path='/api/v1/meters',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def delete_meter(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> None:
+        """Delete meter
+
+        Delete a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._delete_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '204': None,
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def delete_meter_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[None]:
+        """Delete meter
+
+        Delete a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._delete_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '204': None,
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def delete_meter_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Delete meter
+
+        Delete a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._delete_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '204': None,
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _delete_meter_serialize(
+        self,
+        meter_id_or_slug,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='DELETE',
+            resource_path='/api/v1/meters/{meterIdOrSlug}',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def get_meter(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> Meter:
+        """Get meter
+
+        Get a meter by ID or slug.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def get_meter_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[Meter]:
+        """Get meter
+
+        Get a meter by ID or slug.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def get_meter_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Get meter
+
+        Get a meter by ID or slug.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _get_meter_serialize(
+        self,
+        meter_id_or_slug,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/api/v1/meters/{meterIdOrSlug}',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def get_usage_summary(
+        self,
+        subject: Annotated[StrictStr, Field(description="The subject to query usage for (required).")],
+        var_from: Annotated[datetime, Field(description="Start of the time range (RFC 3339, required).")],
+        to: Annotated[datetime, Field(description="End of the time range (RFC 3339, required).")],
+        window_size: Annotated[Optional[UsageSummaryWindowSize], Field(description="Window size for breakdown. Omit for totals only.")] = None,
+        meter_slugs: Annotated[Optional[List[StrictStr]], Field(description="Filter to specific meter slugs. Omit to query all meters.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> MeterUsageSummaryResponse:
+        """Get multi-meter usage summary
+
+        Returns usage across all meters for a subject in a single query. Reads from pre-aggregated materialized views. Meters with unsupported aggregation types (MIN, MAX, UNIQUE_COUNT, LATEST) are omitted until the aggregation table is extended.
+
+        :param subject: The subject to query usage for (required). (required)
+        :type subject: str
+        :param var_from: Start of the time range (RFC 3339, required). (required)
+        :type var_from: datetime
+        :param to: End of the time range (RFC 3339, required). (required)
+        :type to: datetime
+        :param window_size: Window size for breakdown. Omit for totals only.
+        :type window_size: UsageSummaryWindowSize
+        :param meter_slugs: Filter to specific meter slugs. Omit to query all meters.
+        :type meter_slugs: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_usage_summary_serialize(
+            subject=subject,
+            var_from=var_from,
+            to=to,
+            window_size=window_size,
+            meter_slugs=meter_slugs,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterUsageSummaryResponse",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def get_usage_summary_with_http_info(
+        self,
+        subject: Annotated[StrictStr, Field(description="The subject to query usage for (required).")],
+        var_from: Annotated[datetime, Field(description="Start of the time range (RFC 3339, required).")],
+        to: Annotated[datetime, Field(description="End of the time range (RFC 3339, required).")],
+        window_size: Annotated[Optional[UsageSummaryWindowSize], Field(description="Window size for breakdown. Omit for totals only.")] = None,
+        meter_slugs: Annotated[Optional[List[StrictStr]], Field(description="Filter to specific meter slugs. Omit to query all meters.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[MeterUsageSummaryResponse]:
+        """Get multi-meter usage summary
+
+        Returns usage across all meters for a subject in a single query. Reads from pre-aggregated materialized views. Meters with unsupported aggregation types (MIN, MAX, UNIQUE_COUNT, LATEST) are omitted until the aggregation table is extended.
+
+        :param subject: The subject to query usage for (required). (required)
+        :type subject: str
+        :param var_from: Start of the time range (RFC 3339, required). (required)
+        :type var_from: datetime
+        :param to: End of the time range (RFC 3339, required). (required)
+        :type to: datetime
+        :param window_size: Window size for breakdown. Omit for totals only.
+        :type window_size: UsageSummaryWindowSize
+        :param meter_slugs: Filter to specific meter slugs. Omit to query all meters.
+        :type meter_slugs: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_usage_summary_serialize(
+            subject=subject,
+            var_from=var_from,
+            to=to,
+            window_size=window_size,
+            meter_slugs=meter_slugs,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterUsageSummaryResponse",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def get_usage_summary_without_preload_content(
+        self,
+        subject: Annotated[StrictStr, Field(description="The subject to query usage for (required).")],
+        var_from: Annotated[datetime, Field(description="Start of the time range (RFC 3339, required).")],
+        to: Annotated[datetime, Field(description="End of the time range (RFC 3339, required).")],
+        window_size: Annotated[Optional[UsageSummaryWindowSize], Field(description="Window size for breakdown. Omit for totals only.")] = None,
+        meter_slugs: Annotated[Optional[List[StrictStr]], Field(description="Filter to specific meter slugs. Omit to query all meters.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Get multi-meter usage summary
+
+        Returns usage across all meters for a subject in a single query. Reads from pre-aggregated materialized views. Meters with unsupported aggregation types (MIN, MAX, UNIQUE_COUNT, LATEST) are omitted until the aggregation table is extended.
+
+        :param subject: The subject to query usage for (required). (required)
+        :type subject: str
+        :param var_from: Start of the time range (RFC 3339, required). (required)
+        :type var_from: datetime
+        :param to: End of the time range (RFC 3339, required). (required)
+        :type to: datetime
+        :param window_size: Window size for breakdown. Omit for totals only.
+        :type window_size: UsageSummaryWindowSize
+        :param meter_slugs: Filter to specific meter slugs. Omit to query all meters.
+        :type meter_slugs: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_usage_summary_serialize(
+            subject=subject,
+            var_from=var_from,
+            to=to,
+            window_size=window_size,
+            meter_slugs=meter_slugs,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterUsageSummaryResponse",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _get_usage_summary_serialize(
+        self,
+        subject,
+        var_from,
+        to,
+        window_size,
+        meter_slugs,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+            'meterSlugs': 'multi',
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        if subject is not None:
+            
+            _query_params.append(('subject', subject))
+            
+        if var_from is not None:
+            if isinstance(var_from, datetime):
+                _query_params.append(
+                    (
+                        'from',
+                        var_from.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('from', var_from))
+            
+        if to is not None:
+            if isinstance(to, datetime):
+                _query_params.append(
+                    (
+                        'to',
+                        to.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('to', to))
+            
+        if window_size is not None:
+            
+            _query_params.append(('windowSize', window_size.value))
+            
+        if meter_slugs is not None:
+            
+            _query_params.append(('meterSlugs', meter_slugs))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/api/v1/usage/summary',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def list_meter_group_by_values(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        group_by_key: StrictStr,
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive. Defaults to 24 hours ago.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> List[str]:
+        """List meter group by values
+
+        List meter group by values.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param group_by_key: (required)
+        :type group_by_key: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive. Defaults to 24 hours ago.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meter_group_by_values_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            group_by_key=group_by_key,
+            var_from=var_from,
+            to=to,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[str]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def list_meter_group_by_values_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        group_by_key: StrictStr,
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive. Defaults to 24 hours ago.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[List[str]]:
+        """List meter group by values
+
+        List meter group by values.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param group_by_key: (required)
+        :type group_by_key: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive. Defaults to 24 hours ago.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meter_group_by_values_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            group_by_key=group_by_key,
+            var_from=var_from,
+            to=to,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[str]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def list_meter_group_by_values_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        group_by_key: StrictStr,
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive. Defaults to 24 hours ago.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """List meter group by values
+
+        List meter group by values.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param group_by_key: (required)
+        :type group_by_key: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive. Defaults to 24 hours ago.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meter_group_by_values_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            group_by_key=group_by_key,
+            var_from=var_from,
+            to=to,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[str]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _list_meter_group_by_values_serialize(
+        self,
+        meter_id_or_slug,
+        group_by_key,
+        var_from,
+        to,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        if group_by_key is not None:
+            _path_params['groupByKey'] = group_by_key
+        # process the query parameters
+        if var_from is not None:
+            if isinstance(var_from, datetime):
+                _query_params.append(
+                    (
+                        'from',
+                        var_from.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('from', var_from))
+            
+        if to is not None:
+            if isinstance(to, datetime):
+                _query_params.append(
+                    (
+                        'to',
+                        to.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('to', to))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/api/v1/meters/{meterIdOrSlug}/group-by/{groupByKey}/values',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def list_meter_subjects(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive. Defaults to the beginning of time.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> List[str]:
+        """List meter subjects
+
+        List subjects for a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive. Defaults to the beginning of time.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meter_subjects_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            var_from=var_from,
+            to=to,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[str]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def list_meter_subjects_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive. Defaults to the beginning of time.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[List[str]]:
+        """List meter subjects
+
+        List subjects for a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive. Defaults to the beginning of time.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meter_subjects_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            var_from=var_from,
+            to=to,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[str]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def list_meter_subjects_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive. Defaults to the beginning of time.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """List meter subjects
+
+        List subjects for a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive. Defaults to the beginning of time.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meter_subjects_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            var_from=var_from,
+            to=to,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[str]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _list_meter_subjects_serialize(
+        self,
+        meter_id_or_slug,
+        var_from,
+        to,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        # process the query parameters
+        if var_from is not None:
+            if isinstance(var_from, datetime):
+                _query_params.append(
+                    (
+                        'from',
+                        var_from.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('from', var_from))
+            
+        if to is not None:
+            if isinstance(to, datetime):
+                _query_params.append(
+                    (
+                        'to',
+                        to.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('to', to))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/api/v1/meters/{meterIdOrSlug}/subjects',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def list_meters(
+        self,
+        page: Annotated[Optional[Annotated[int, Field(strict=True, ge=1)]], Field(description="Page index.  Default is 1.")] = None,
+        page_size: Annotated[Optional[Annotated[int, Field(le=1000, strict=True, ge=1)]], Field(description="The maximum number of items per page.  Default is 100.")] = None,
+        order: Annotated[Optional[SortOrder], Field(description="The order direction.")] = None,
+        order_by: Annotated[Optional[MeterOrderBy], Field(description="The order by field.")] = None,
+        include_deleted: Annotated[Optional[StrictBool], Field(description="Include deleted meters.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> List[Meter]:
+        """List meters
+
+        List meters.
+
+        :param page: Page index.  Default is 1.
+        :type page: int
+        :param page_size: The maximum number of items per page.  Default is 100.
+        :type page_size: int
+        :param order: The order direction.
+        :type order: SortOrder
+        :param order_by: The order by field.
+        :type order_by: MeterOrderBy
+        :param include_deleted: Include deleted meters.
+        :type include_deleted: bool
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meters_serialize(
+            page=page,
+            page_size=page_size,
+            order=order,
+            order_by=order_by,
+            include_deleted=include_deleted,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[Meter]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def list_meters_with_http_info(
+        self,
+        page: Annotated[Optional[Annotated[int, Field(strict=True, ge=1)]], Field(description="Page index.  Default is 1.")] = None,
+        page_size: Annotated[Optional[Annotated[int, Field(le=1000, strict=True, ge=1)]], Field(description="The maximum number of items per page.  Default is 100.")] = None,
+        order: Annotated[Optional[SortOrder], Field(description="The order direction.")] = None,
+        order_by: Annotated[Optional[MeterOrderBy], Field(description="The order by field.")] = None,
+        include_deleted: Annotated[Optional[StrictBool], Field(description="Include deleted meters.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[List[Meter]]:
+        """List meters
+
+        List meters.
+
+        :param page: Page index.  Default is 1.
+        :type page: int
+        :param page_size: The maximum number of items per page.  Default is 100.
+        :type page_size: int
+        :param order: The order direction.
+        :type order: SortOrder
+        :param order_by: The order by field.
+        :type order_by: MeterOrderBy
+        :param include_deleted: Include deleted meters.
+        :type include_deleted: bool
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meters_serialize(
+            page=page,
+            page_size=page_size,
+            order=order,
+            order_by=order_by,
+            include_deleted=include_deleted,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[Meter]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def list_meters_without_preload_content(
+        self,
+        page: Annotated[Optional[Annotated[int, Field(strict=True, ge=1)]], Field(description="Page index.  Default is 1.")] = None,
+        page_size: Annotated[Optional[Annotated[int, Field(le=1000, strict=True, ge=1)]], Field(description="The maximum number of items per page.  Default is 100.")] = None,
+        order: Annotated[Optional[SortOrder], Field(description="The order direction.")] = None,
+        order_by: Annotated[Optional[MeterOrderBy], Field(description="The order by field.")] = None,
+        include_deleted: Annotated[Optional[StrictBool], Field(description="Include deleted meters.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """List meters
+
+        List meters.
+
+        :param page: Page index.  Default is 1.
+        :type page: int
+        :param page_size: The maximum number of items per page.  Default is 100.
+        :type page_size: int
+        :param order: The order direction.
+        :type order: SortOrder
+        :param order_by: The order by field.
+        :type order_by: MeterOrderBy
+        :param include_deleted: Include deleted meters.
+        :type include_deleted: bool
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_meters_serialize(
+            page=page,
+            page_size=page_size,
+            order=order,
+            order_by=order_by,
+            include_deleted=include_deleted,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "List[Meter]",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _list_meters_serialize(
+        self,
+        page,
+        page_size,
+        order,
+        order_by,
+        include_deleted,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        if page is not None:
+            
+            _query_params.append(('page', page))
+            
+        if page_size is not None:
+            
+            _query_params.append(('pageSize', page_size))
+            
+        if order is not None:
+            
+            _query_params.append(('order', order.value))
+            
+        if order_by is not None:
+            
+            _query_params.append(('orderBy', order_by.value))
+            
+        if include_deleted is not None:
+            
+            _query_params.append(('includeDeleted', include_deleted))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/api/v1/meters',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def query_meter(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        client_id: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True, max_length=36)]], Field(description="Client ID Useful to track progress of a query.")] = None,
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        window_size: Annotated[Optional[WindowSize], Field(description="If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group.  For example: ?windowSize=DAY")] = None,
+        window_time_zone: Annotated[Optional[StrictStr], Field(description="The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones). If not specified, the UTC timezone will be used.  For example: ?windowTimeZone=UTC")] = None,
+        subject: Annotated[Optional[List[StrictStr]], Field(description="Filtering by multiple subjects.  For example: ?subject=subject-1&subject=subject-2")] = None,
+        filter_customer_id: Annotated[Optional[Annotated[List[StrictStr], Field(max_length=100)]], Field(description="Filtering by multiple customers.  For example: ?filterCustomerId=customer-1&filterCustomerId=customer-2")] = None,
+        filter_group_by: Annotated[Optional[Dict[str, Dict[str, StrictStr]]], Field(description="Simple filter for group bys with exact match.  For example: ?filterGroupBy[vendor]=openai&filterGroupBy[model]=gpt-4-turbo")] = None,
+        advanced_meter_group_by_filters: Annotated[Optional[Dict[str, FilterString]], Field(description="Optional advanced meter group by filters. You can use this to filter for values of the meter groupBy fields.")] = None,
+        group_by: Annotated[Optional[List[StrictStr]], Field(description="If not specified a single aggregate will be returned for each subject and time window. `subject` is a reserved group by value.  For example: ?groupBy=subject&groupBy=model")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> MeterQueryResult:
+        """Query meter
+
+        Query meter for usage.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param client_id: Client ID Useful to track progress of a query.
+        :type client_id: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param window_size: If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group.  For example: ?windowSize=DAY
+        :type window_size: WindowSize
+        :param window_time_zone: The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones). If not specified, the UTC timezone will be used.  For example: ?windowTimeZone=UTC
+        :type window_time_zone: str
+        :param subject: Filtering by multiple subjects.  For example: ?subject=subject-1&subject=subject-2
+        :type subject: List[str]
+        :param filter_customer_id: Filtering by multiple customers.  For example: ?filterCustomerId=customer-1&filterCustomerId=customer-2
+        :type filter_customer_id: List[str]
+        :param filter_group_by: Simple filter for group bys with exact match.  For example: ?filterGroupBy[vendor]=openai&filterGroupBy[model]=gpt-4-turbo
+        :type filter_group_by: Dict[str, str]
+        :param advanced_meter_group_by_filters: Optional advanced meter group by filters. You can use this to filter for values of the meter groupBy fields.
+        :type advanced_meter_group_by_filters: Dict[str, FilterString]
+        :param group_by: If not specified a single aggregate will be returned for each subject and time window. `subject` is a reserved group by value.  For example: ?groupBy=subject&groupBy=model
+        :type group_by: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._query_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            client_id=client_id,
+            var_from=var_from,
+            to=to,
+            window_size=window_size,
+            window_time_zone=window_time_zone,
+            subject=subject,
+            filter_customer_id=filter_customer_id,
+            filter_group_by=filter_group_by,
+            advanced_meter_group_by_filters=advanced_meter_group_by_filters,
+            group_by=group_by,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterQueryResult",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def query_meter_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        client_id: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True, max_length=36)]], Field(description="Client ID Useful to track progress of a query.")] = None,
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        window_size: Annotated[Optional[WindowSize], Field(description="If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group.  For example: ?windowSize=DAY")] = None,
+        window_time_zone: Annotated[Optional[StrictStr], Field(description="The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones). If not specified, the UTC timezone will be used.  For example: ?windowTimeZone=UTC")] = None,
+        subject: Annotated[Optional[List[StrictStr]], Field(description="Filtering by multiple subjects.  For example: ?subject=subject-1&subject=subject-2")] = None,
+        filter_customer_id: Annotated[Optional[Annotated[List[StrictStr], Field(max_length=100)]], Field(description="Filtering by multiple customers.  For example: ?filterCustomerId=customer-1&filterCustomerId=customer-2")] = None,
+        filter_group_by: Annotated[Optional[Dict[str, Dict[str, StrictStr]]], Field(description="Simple filter for group bys with exact match.  For example: ?filterGroupBy[vendor]=openai&filterGroupBy[model]=gpt-4-turbo")] = None,
+        advanced_meter_group_by_filters: Annotated[Optional[Dict[str, FilterString]], Field(description="Optional advanced meter group by filters. You can use this to filter for values of the meter groupBy fields.")] = None,
+        group_by: Annotated[Optional[List[StrictStr]], Field(description="If not specified a single aggregate will be returned for each subject and time window. `subject` is a reserved group by value.  For example: ?groupBy=subject&groupBy=model")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[MeterQueryResult]:
+        """Query meter
+
+        Query meter for usage.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param client_id: Client ID Useful to track progress of a query.
+        :type client_id: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param window_size: If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group.  For example: ?windowSize=DAY
+        :type window_size: WindowSize
+        :param window_time_zone: The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones). If not specified, the UTC timezone will be used.  For example: ?windowTimeZone=UTC
+        :type window_time_zone: str
+        :param subject: Filtering by multiple subjects.  For example: ?subject=subject-1&subject=subject-2
+        :type subject: List[str]
+        :param filter_customer_id: Filtering by multiple customers.  For example: ?filterCustomerId=customer-1&filterCustomerId=customer-2
+        :type filter_customer_id: List[str]
+        :param filter_group_by: Simple filter for group bys with exact match.  For example: ?filterGroupBy[vendor]=openai&filterGroupBy[model]=gpt-4-turbo
+        :type filter_group_by: Dict[str, str]
+        :param advanced_meter_group_by_filters: Optional advanced meter group by filters. You can use this to filter for values of the meter groupBy fields.
+        :type advanced_meter_group_by_filters: Dict[str, FilterString]
+        :param group_by: If not specified a single aggregate will be returned for each subject and time window. `subject` is a reserved group by value.  For example: ?groupBy=subject&groupBy=model
+        :type group_by: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._query_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            client_id=client_id,
+            var_from=var_from,
+            to=to,
+            window_size=window_size,
+            window_time_zone=window_time_zone,
+            subject=subject,
+            filter_customer_id=filter_customer_id,
+            filter_group_by=filter_group_by,
+            advanced_meter_group_by_filters=advanced_meter_group_by_filters,
+            group_by=group_by,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterQueryResult",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def query_meter_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        client_id: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True, max_length=36)]], Field(description="Client ID Useful to track progress of a query.")] = None,
+        var_from: Annotated[Optional[datetime], Field(description="Start date-time in RFC 3339 format.  Inclusive.  For example: ?from=2025-01-01T00%3A00%3A00.000Z")] = None,
+        to: Annotated[Optional[datetime], Field(description="End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z")] = None,
+        window_size: Annotated[Optional[WindowSize], Field(description="If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group.  For example: ?windowSize=DAY")] = None,
+        window_time_zone: Annotated[Optional[StrictStr], Field(description="The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones). If not specified, the UTC timezone will be used.  For example: ?windowTimeZone=UTC")] = None,
+        subject: Annotated[Optional[List[StrictStr]], Field(description="Filtering by multiple subjects.  For example: ?subject=subject-1&subject=subject-2")] = None,
+        filter_customer_id: Annotated[Optional[Annotated[List[StrictStr], Field(max_length=100)]], Field(description="Filtering by multiple customers.  For example: ?filterCustomerId=customer-1&filterCustomerId=customer-2")] = None,
+        filter_group_by: Annotated[Optional[Dict[str, Dict[str, StrictStr]]], Field(description="Simple filter for group bys with exact match.  For example: ?filterGroupBy[vendor]=openai&filterGroupBy[model]=gpt-4-turbo")] = None,
+        advanced_meter_group_by_filters: Annotated[Optional[Dict[str, FilterString]], Field(description="Optional advanced meter group by filters. You can use this to filter for values of the meter groupBy fields.")] = None,
+        group_by: Annotated[Optional[List[StrictStr]], Field(description="If not specified a single aggregate will be returned for each subject and time window. `subject` is a reserved group by value.  For example: ?groupBy=subject&groupBy=model")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Query meter
+
+        Query meter for usage.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param client_id: Client ID Useful to track progress of a query.
+        :type client_id: str
+        :param var_from: Start date-time in RFC 3339 format.  Inclusive.  For example: ?from=2025-01-01T00%3A00%3A00.000Z
+        :type var_from: datetime
+        :param to: End date-time in RFC 3339 format.  Inclusive.  For example: ?to=2025-02-01T00%3A00%3A00.000Z
+        :type to: datetime
+        :param window_size: If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group.  For example: ?windowSize=DAY
+        :type window_size: WindowSize
+        :param window_time_zone: The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones). If not specified, the UTC timezone will be used.  For example: ?windowTimeZone=UTC
+        :type window_time_zone: str
+        :param subject: Filtering by multiple subjects.  For example: ?subject=subject-1&subject=subject-2
+        :type subject: List[str]
+        :param filter_customer_id: Filtering by multiple customers.  For example: ?filterCustomerId=customer-1&filterCustomerId=customer-2
+        :type filter_customer_id: List[str]
+        :param filter_group_by: Simple filter for group bys with exact match.  For example: ?filterGroupBy[vendor]=openai&filterGroupBy[model]=gpt-4-turbo
+        :type filter_group_by: Dict[str, str]
+        :param advanced_meter_group_by_filters: Optional advanced meter group by filters. You can use this to filter for values of the meter groupBy fields.
+        :type advanced_meter_group_by_filters: Dict[str, FilterString]
+        :param group_by: If not specified a single aggregate will be returned for each subject and time window. `subject` is a reserved group by value.  For example: ?groupBy=subject&groupBy=model
+        :type group_by: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._query_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            client_id=client_id,
+            var_from=var_from,
+            to=to,
+            window_size=window_size,
+            window_time_zone=window_time_zone,
+            subject=subject,
+            filter_customer_id=filter_customer_id,
+            filter_group_by=filter_group_by,
+            advanced_meter_group_by_filters=advanced_meter_group_by_filters,
+            group_by=group_by,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterQueryResult",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _query_meter_serialize(
+        self,
+        meter_id_or_slug,
+        client_id,
+        var_from,
+        to,
+        window_size,
+        window_time_zone,
+        subject,
+        filter_customer_id,
+        filter_group_by,
+        advanced_meter_group_by_filters,
+        group_by,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+            'subject': 'multi',
+            'filterCustomerId': 'multi',
+            'groupBy': 'multi',
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        # process the query parameters
+        if client_id is not None:
+            
+            _query_params.append(('clientId', client_id))
+            
+        if var_from is not None:
+            if isinstance(var_from, datetime):
+                _query_params.append(
+                    (
+                        'from',
+                        var_from.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('from', var_from))
+            
+        if to is not None:
+            if isinstance(to, datetime):
+                _query_params.append(
+                    (
+                        'to',
+                        to.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('to', to))
+            
+        if window_size is not None:
+            
+            _query_params.append(('windowSize', window_size.value))
+            
+        if window_time_zone is not None:
+            
+            _query_params.append(('windowTimeZone', window_time_zone))
+            
+        if subject is not None:
+            
+            _query_params.append(('subject', subject))
+            
+        if filter_customer_id is not None:
+            
+            _query_params.append(('filterCustomerId', filter_customer_id))
+            
+        if filter_group_by is not None:
+            
+            _query_params.append(('filterGroupBy', filter_group_by))
+            
+        if advanced_meter_group_by_filters is not None:
+            
+            _query_params.append(('advancedMeterGroupByFilters', advanced_meter_group_by_filters))
+            
+        if group_by is not None:
+            
+            _query_params.append(('groupBy', group_by))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'text/csv', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/api/v1/meters/{meterIdOrSlug}/query',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def query_meter_post(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_query_request: MeterQueryRequest,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> MeterQueryResult:
+        """Query meter
+
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_query_request: (required)
+        :type meter_query_request: MeterQueryRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._query_meter_post_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_query_request=meter_query_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterQueryResult",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def query_meter_post_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_query_request: MeterQueryRequest,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[MeterQueryResult]:
+        """Query meter
+
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_query_request: (required)
+        :type meter_query_request: MeterQueryRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._query_meter_post_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_query_request=meter_query_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterQueryResult",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def query_meter_post_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_query_request: MeterQueryRequest,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Query meter
+
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_query_request: (required)
+        :type meter_query_request: MeterQueryRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._query_meter_post_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_query_request=meter_query_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterQueryResult",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _query_meter_post_serialize(
+        self,
+        meter_id_or_slug,
+        meter_query_request,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if meter_query_request is not None:
+            _body_params = meter_query_request
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='POST',
+            resource_path='/api/v1/meters/{meterIdOrSlug}/query',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def test_meter_event(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_test_event_request: MeterTestEventRequest,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> MeterTestEventResponse:
+        """Validate a sample event payload against the meter
+
+        Validate a sample event payload against the meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_test_event_request: (required)
+        :type meter_test_event_request: MeterTestEventRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._test_meter_event_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_test_event_request=meter_test_event_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterTestEventResponse",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def test_meter_event_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_test_event_request: MeterTestEventRequest,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[MeterTestEventResponse]:
+        """Validate a sample event payload against the meter
+
+        Validate a sample event payload against the meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_test_event_request: (required)
+        :type meter_test_event_request: MeterTestEventRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._test_meter_event_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_test_event_request=meter_test_event_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterTestEventResponse",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def test_meter_event_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_test_event_request: MeterTestEventRequest,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Validate a sample event payload against the meter
+
+        Validate a sample event payload against the meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_test_event_request: (required)
+        :type meter_test_event_request: MeterTestEventRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._test_meter_event_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_test_event_request=meter_test_event_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "MeterTestEventResponse",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '404': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _test_meter_event_serialize(
+        self,
+        meter_id_or_slug,
+        meter_test_event_request,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if meter_test_event_request is not None:
+            _body_params = meter_test_event_request
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='POST',
+            resource_path='/api/v1/meters/{meterIdOrSlug}/test-event',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def update_meter(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_update: MeterUpdate,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> Meter:
+        """Update meter
+
+        Update a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_update: (required)
+        :type meter_update: MeterUpdate
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._update_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_update=meter_update,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def update_meter_with_http_info(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_update: MeterUpdate,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[Meter]:
+        """Update meter
+
+        Update a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_update: (required)
+        :type meter_update: MeterUpdate
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._update_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_update=meter_update,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def update_meter_without_preload_content(
+        self,
+        meter_id_or_slug: Annotated[str, Field(min_length=1, strict=True, max_length=64)],
+        meter_update: MeterUpdate,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Update meter
+
+        Update a meter.
+
+        :param meter_id_or_slug: (required)
+        :type meter_id_or_slug: str
+        :param meter_update: (required)
+        :type meter_update: MeterUpdate
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._update_meter_serialize(
+            meter_id_or_slug=meter_id_or_slug,
+            meter_update=meter_update,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Meter",
+            '400': "UnexpectedProblemResponse",
+            '401': "UnexpectedProblemResponse",
+            '403': "UnexpectedProblemResponse",
+            '412': "UnexpectedProblemResponse",
+            '500': "UnexpectedProblemResponse",
+            '503': "UnexpectedProblemResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _update_meter_serialize(
+        self,
+        meter_id_or_slug,
+        meter_update,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if meter_id_or_slug is not None:
+            _path_params['meterIdOrSlug'] = meter_id_or_slug
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if meter_update is not None:
+            _body_params = meter_update
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'CloudTokenAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='PUT',
+            resource_path='/api/v1/meters/{meterIdOrSlug}',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+