samsara-api 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

samsara/alerts/configurations/client.py

@@ -3,11 +3,14 @@
 import typing
 
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.pagination import AsyncPager, SyncPager
 from ...core.request_options import RequestOptions
 from ...types.action_object_request_body import ActionObjectRequestBody
-from ...types.alerts_get_configurations_response_body import AlertsGetConfigurationsResponseBody
 from ...types.alerts_patch_configurations_response_body import AlertsPatchConfigurationsResponseBody
 from ...types.alerts_post_configurations_response_body import AlertsPostConfigurationsResponseBody
+from ...types.get_response_workflow_configuration_object_response_body import (
+    GetResponseWorkflowConfigurationObjectResponseBody,
+)
 from ...types.operational_settings_object_request_body import OperationalSettingsObjectRequestBody
 from ...types.scope_object_request_body import ScopeObjectRequestBody
 from ...types.workflow_trigger_object_request_body import WorkflowTriggerObjectRequestBody
@@ -41,7 +44,7 @@ class ConfigurationsClient:
         after: typing.Optional[str] = None,
         include_external_ids: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AlertsGetConfigurationsResponseBody:
+    ) -> SyncPager[GetResponseWorkflowConfigurationObjectResponseBody]:
         """
         Get specified Alert Configurations.
 
@@ -74,6 +77,7 @@ class ConfigurationsClient:
         Gateway Disconnected
         Panic Button
         Tampering Detected
+        Asset Reading
         If vehicle is severely speeding (as defined by your organization)
         DVIR Submitted for Asset
         Driver Document Submitted
@@ -115,7 +119,7 @@ class ConfigurationsClient:
 
         Returns
         -------
-        AlertsGetConfigurationsResponseBody
+        SyncPager[GetResponseWorkflowConfigurationObjectResponseBody]
             OK response.
 
         Examples
@@ -125,16 +129,20 @@ class ConfigurationsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.alerts.configurations.list()
+        response = client.alerts.configurations.list()
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
         """
-        _response = self._raw_client.list(
+        return self._raw_client.list(
             ids=ids,
             status=status,
             after=after,
             include_external_ids=include_external_ids,
             request_options=request_options,
         )
-        return _response.data
 
     def create(
         self,
@@ -369,7 +377,7 @@ class AsyncConfigurationsClient:
         after: typing.Optional[str] = None,
         include_external_ids: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AlertsGetConfigurationsResponseBody:
+    ) -> AsyncPager[GetResponseWorkflowConfigurationObjectResponseBody]:
         """
         Get specified Alert Configurations.
 
@@ -402,6 +410,7 @@ class AsyncConfigurationsClient:
         Gateway Disconnected
         Panic Button
         Tampering Detected
+        Asset Reading
         If vehicle is severely speeding (as defined by your organization)
         DVIR Submitted for Asset
         Driver Document Submitted
@@ -443,7 +452,7 @@ class AsyncConfigurationsClient:
 
         Returns
         -------
-        AlertsGetConfigurationsResponseBody
+        AsyncPager[GetResponseWorkflowConfigurationObjectResponseBody]
             OK response.
 
         Examples
@@ -458,19 +467,24 @@ class AsyncConfigurationsClient:
 
 
         async def main() -> None:
-            await client.alerts.configurations.list()
+            response = await client.alerts.configurations.list()
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(
+        return await self._raw_client.list(
             ids=ids,
             status=status,
             after=after,
             include_external_ids=include_external_ids,
             request_options=request_options,
         )
-        return _response.data
 
     async def create(
         self,

samsara/alerts/configurations/raw_client.py

@@ -6,6 +6,7 @@ from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.http_response import AsyncHttpResponse, HttpResponse
+from ...core.pagination import AsyncPager, BaseHttpResponse, SyncPager
 from ...core.pydantic_utilities import parse_obj_as
 from ...core.request_options import RequestOptions
 from ...core.serialization import convert_and_respect_annotation_metadata
@@ -22,6 +23,9 @@ from ...types.action_object_request_body import ActionObjectRequestBody
 from ...types.alerts_get_configurations_response_body import AlertsGetConfigurationsResponseBody
 from ...types.alerts_patch_configurations_response_body import AlertsPatchConfigurationsResponseBody
 from ...types.alerts_post_configurations_response_body import AlertsPostConfigurationsResponseBody
+from ...types.get_response_workflow_configuration_object_response_body import (
+    GetResponseWorkflowConfigurationObjectResponseBody,
+)
 from ...types.operational_settings_object_request_body import OperationalSettingsObjectRequestBody
 from ...types.scope_object_request_body import ScopeObjectRequestBody
 from ...types.workflow_trigger_object_request_body import WorkflowTriggerObjectRequestBody
@@ -43,7 +47,7 @@ class RawConfigurationsClient:
         after: typing.Optional[str] = None,
         include_external_ids: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[AlertsGetConfigurationsResponseBody]:
+    ) -> SyncPager[GetResponseWorkflowConfigurationObjectResponseBody]:
         """
         Get specified Alert Configurations.
 
@@ -76,6 +80,7 @@ class RawConfigurationsClient:
         Gateway Disconnected
         Panic Button
         Tampering Detected
+        Asset Reading
         If vehicle is severely speeding (as defined by your organization)
         DVIR Submitted for Asset
         Driver Document Submitted
@@ -117,7 +122,7 @@ class RawConfigurationsClient:
 
         Returns
         -------
-        HttpResponse[AlertsGetConfigurationsResponseBody]
+        SyncPager[GetResponseWorkflowConfigurationObjectResponseBody]
             OK response.
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -133,14 +138,29 @@ class RawConfigurationsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     AlertsGetConfigurationsResponseBody,
                     parse_obj_as(
                         type_=AlertsGetConfigurationsResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return HttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+                    _get_next = lambda: self.list(
+                        ids=ids,
+                        status=status,
+                        after=_parsed_next,
+                        include_external_ids=include_external_ids,
+                        request_options=request_options,
+                    )
+                return SyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),
@@ -783,7 +803,7 @@ class AsyncRawConfigurationsClient:
         after: typing.Optional[str] = None,
         include_external_ids: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[AlertsGetConfigurationsResponseBody]:
+    ) -> AsyncPager[GetResponseWorkflowConfigurationObjectResponseBody]:
         """
         Get specified Alert Configurations.
 
@@ -816,6 +836,7 @@ class AsyncRawConfigurationsClient:
         Gateway Disconnected
         Panic Button
         Tampering Detected
+        Asset Reading
         If vehicle is severely speeding (as defined by your organization)
         DVIR Submitted for Asset
         Driver Document Submitted
@@ -857,7 +878,7 @@ class AsyncRawConfigurationsClient:
 
         Returns
         -------
-        AsyncHttpResponse[AlertsGetConfigurationsResponseBody]
+        AsyncPager[GetResponseWorkflowConfigurationObjectResponseBody]
             OK response.
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -873,14 +894,32 @@ class AsyncRawConfigurationsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     AlertsGetConfigurationsResponseBody,
                     parse_obj_as(
                         type_=AlertsGetConfigurationsResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return AsyncHttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+
+                    async def _get_next():
+                        return await self.list(
+                            ids=ids,
+                            status=status,
+                            after=_parsed_next,
+                            include_external_ids=include_external_ids,
+                            request_options=request_options,
+                        )
+
+                return AsyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),

samsara/alerts/incidents/client.py

@@ -3,8 +3,9 @@
 import typing
 
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.pagination import AsyncPager, SyncPager
 from ...core.request_options import RequestOptions
-from ...types.alerts_get_incidents_response_body import AlertsGetIncidentsResponseBody
+from ...types.get_workflow_incident_response_object_response_body import GetWorkflowIncidentResponseObjectResponseBody
 from .raw_client import AsyncRawIncidentsClient, RawIncidentsClient
 
 
@@ -31,7 +32,7 @@ class IncidentsClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AlertsGetIncidentsResponseBody:
+    ) -> SyncPager[GetWorkflowIncidentResponseObjectResponseBody]:
         """
         Get Alert Incidents for specific Alert Configurations over a specified period of time.
 
@@ -61,7 +62,7 @@ class IncidentsClient:
 
         Returns
         -------
-        AlertsGetIncidentsResponseBody
+        SyncPager[GetWorkflowIncidentResponseObjectResponseBody]
             OK response.
 
         Examples
@@ -71,18 +72,22 @@ class IncidentsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.alerts.incidents.stream(
+        response = client.alerts.incidents.stream(
             start_time="startTime",
         )
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
         """
-        _response = self._raw_client.stream(
+        return self._raw_client.stream(
             start_time=start_time,
             configuration_ids=configuration_ids,
             end_time=end_time,
             after=after,
             request_options=request_options,
         )
-        return _response.data
 
 
 class AsyncIncidentsClient:
@@ -108,7 +113,7 @@ class AsyncIncidentsClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AlertsGetIncidentsResponseBody:
+    ) -> AsyncPager[GetWorkflowIncidentResponseObjectResponseBody]:
         """
         Get Alert Incidents for specific Alert Configurations over a specified period of time.
 
@@ -138,7 +143,7 @@ class AsyncIncidentsClient:
 
         Returns
         -------
-        AlertsGetIncidentsResponseBody
+        AsyncPager[GetWorkflowIncidentResponseObjectResponseBody]
             OK response.
 
         Examples
@@ -153,18 +158,23 @@ class AsyncIncidentsClient:
 
 
         async def main() -> None:
-            await client.alerts.incidents.stream(
+            response = await client.alerts.incidents.stream(
                 start_time="startTime",
             )
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.stream(
+        return await self._raw_client.stream(
             start_time=start_time,
             configuration_ids=configuration_ids,
             end_time=end_time,
             after=after,
             request_options=request_options,
         )
-        return _response.data

samsara/alerts/incidents/raw_client.py

@@ -5,7 +5,7 @@ from json.decoder import JSONDecodeError
 
 from ...core.api_error import ApiError
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
-from ...core.http_response import AsyncHttpResponse, HttpResponse
+from ...core.pagination import AsyncPager, BaseHttpResponse, SyncPager
 from ...core.pydantic_utilities import parse_obj_as
 from ...core.request_options import RequestOptions
 from ...errors.bad_gateway_error import BadGatewayError
@@ -18,6 +18,7 @@ from ...errors.service_unavailable_error import ServiceUnavailableError
 from ...errors.too_many_requests_error import TooManyRequestsError
 from ...errors.unauthorized_error import UnauthorizedError
 from ...types.alerts_get_incidents_response_body import AlertsGetIncidentsResponseBody
+from ...types.get_workflow_incident_response_object_response_body import GetWorkflowIncidentResponseObjectResponseBody
 
 
 class RawIncidentsClient:
@@ -32,7 +33,7 @@ class RawIncidentsClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[AlertsGetIncidentsResponseBody]:
+    ) -> SyncPager[GetWorkflowIncidentResponseObjectResponseBody]:
         """
         Get Alert Incidents for specific Alert Configurations over a specified period of time.
 
@@ -62,7 +63,7 @@ class RawIncidentsClient:
 
         Returns
         -------
-        HttpResponse[AlertsGetIncidentsResponseBody]
+        SyncPager[GetWorkflowIncidentResponseObjectResponseBody]
             OK response.
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -78,14 +79,29 @@ class RawIncidentsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     AlertsGetIncidentsResponseBody,
                     parse_obj_as(
                         type_=AlertsGetIncidentsResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return HttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+                    _get_next = lambda: self.stream(
+                        start_time=start_time,
+                        configuration_ids=configuration_ids,
+                        end_time=end_time,
+                        after=_parsed_next,
+                        request_options=request_options,
+                    )
+                return SyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),
@@ -203,7 +219,7 @@ class AsyncRawIncidentsClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[AlertsGetIncidentsResponseBody]:
+    ) -> AsyncPager[GetWorkflowIncidentResponseObjectResponseBody]:
         """
         Get Alert Incidents for specific Alert Configurations over a specified period of time.
 
@@ -233,7 +249,7 @@ class AsyncRawIncidentsClient:
 
         Returns
         -------
-        AsyncHttpResponse[AlertsGetIncidentsResponseBody]
+        AsyncPager[GetWorkflowIncidentResponseObjectResponseBody]
             OK response.
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -249,14 +265,32 @@ class AsyncRawIncidentsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     AlertsGetIncidentsResponseBody,
                     parse_obj_as(
                         type_=AlertsGetIncidentsResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return AsyncHttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+
+                    async def _get_next():
+                        return await self.stream(
+                            start_time=start_time,
+                            configuration_ids=configuration_ids,
+                            end_time=end_time,
+                            after=_parsed_next,
+                            request_options=request_options,
+                        )
+
+                return AsyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),

samsara/assets/client.py

@@ -3,9 +3,10 @@
 import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
 from ..core.request_options import RequestOptions
+from ..types.asset_response_body import AssetResponseBody
 from ..types.assets_create_asset_response_body import AssetsCreateAssetResponseBody
-from ..types.assets_list_assets_response_body import AssetsListAssetsResponseBody
 from ..types.assets_update_asset_response_body import AssetsUpdateAssetResponseBody
 from .location_and_speed.client import AsyncLocationAndSpeedClient, LocationAndSpeedClient
 from .raw_client import AsyncRawAssetsClient, RawAssetsClient
@@ -48,7 +49,7 @@ class AssetsClient:
         ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         attribute_value_ids: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AssetsListAssetsResponseBody:
+    ) -> SyncPager[AssetResponseBody]:
         """
         List all assets. Up to 300 assets will be returned per page.
 
@@ -93,7 +94,7 @@ class AssetsClient:
 
         Returns
         -------
-        AssetsListAssetsResponseBody
+        SyncPager[AssetResponseBody]
             OK response.
 
         Examples
@@ -103,9 +104,14 @@ class AssetsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.assets.list()
+        response = client.assets.list()
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
         """
-        _response = self._raw_client.list(
+        return self._raw_client.list(
             type=type,
             after=after,
             updated_after_time=updated_after_time,
@@ -117,7 +123,6 @@ class AssetsClient:
             attribute_value_ids=attribute_value_ids,
             request_options=request_options,
         )
-        return _response.data
 
     def create(
         self,
@@ -381,7 +386,7 @@ class AsyncAssetsClient:
         ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         attribute_value_ids: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AssetsListAssetsResponseBody:
+    ) -> AsyncPager[AssetResponseBody]:
         """
         List all assets. Up to 300 assets will be returned per page.
 
@@ -426,7 +431,7 @@ class AsyncAssetsClient:
 
         Returns
         -------
-        AssetsListAssetsResponseBody
+        AsyncPager[AssetResponseBody]
             OK response.
 
         Examples
@@ -441,12 +446,18 @@ class AsyncAssetsClient:
 
 
         async def main() -> None:
-            await client.assets.list()
+            response = await client.assets.list()
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(
+        return await self._raw_client.list(
             type=type,
             after=after,
             updated_after_time=updated_after_time,
@@ -458,7 +469,6 @@ class AsyncAssetsClient:
             attribute_value_ids=attribute_value_ids,
             request_options=request_options,
         )
-        return _response.data
 
     async def create(
         self,

samsara/assets/location_and_speed/client.py

@@ -3,10 +3,9 @@
 import typing
 
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.pagination import AsyncPager, SyncPager
 from ...core.request_options import RequestOptions
-from ...types.location_and_speed_get_location_and_speed_response_body import (
-    LocationAndSpeedGetLocationAndSpeedResponseBody,
-)
+from ...types.location_and_speed_response_response_body import LocationAndSpeedResponseResponseBody
 from .raw_client import AsyncRawLocationAndSpeedClient, RawLocationAndSpeedClient
 
 
@@ -38,7 +37,7 @@ class LocationAndSpeedClient:
         include_geofence_lookup: typing.Optional[bool] = None,
         include_external_ids: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> LocationAndSpeedGetLocationAndSpeedResponseBody:
+    ) -> SyncPager[LocationAndSpeedResponseResponseBody]:
         """
         This endpoint will return asset locations and speed data that has been collected for your organization based on the time parameters passed in. Results are paginated. If you include an endTime, the endpoint will return data up until that point. If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. The endpoint will only return data up until the endTime that has been processed by the server at the time of the original request. You will need to request the same [startTime, endTime) range again to receive data for assets processed after the original request time. This endpoint sorts the time-series data by device.
 
@@ -83,7 +82,7 @@ class LocationAndSpeedClient:
 
         Returns
         -------
-        LocationAndSpeedGetLocationAndSpeedResponseBody
+        SyncPager[LocationAndSpeedResponseResponseBody]
             OK response.
 
         Examples
@@ -93,9 +92,14 @@ class LocationAndSpeedClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.assets.location_and_speed.stream()
+        response = client.assets.location_and_speed.stream()
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
         """
-        _response = self._raw_client.stream(
+        return self._raw_client.stream(
             after=after,
             limit=limit,
             start_time=start_time,
@@ -107,7 +111,6 @@ class LocationAndSpeedClient:
             include_external_ids=include_external_ids,
             request_options=request_options,
         )
-        return _response.data
 
 
 class AsyncLocationAndSpeedClient:
@@ -138,7 +141,7 @@ class AsyncLocationAndSpeedClient:
         include_geofence_lookup: typing.Optional[bool] = None,
         include_external_ids: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> LocationAndSpeedGetLocationAndSpeedResponseBody:
+    ) -> AsyncPager[LocationAndSpeedResponseResponseBody]:
         """
         This endpoint will return asset locations and speed data that has been collected for your organization based on the time parameters passed in. Results are paginated. If you include an endTime, the endpoint will return data up until that point. If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. The endpoint will only return data up until the endTime that has been processed by the server at the time of the original request. You will need to request the same [startTime, endTime) range again to receive data for assets processed after the original request time. This endpoint sorts the time-series data by device.
 
@@ -183,7 +186,7 @@ class AsyncLocationAndSpeedClient:
 
         Returns
         -------
-        LocationAndSpeedGetLocationAndSpeedResponseBody
+        AsyncPager[LocationAndSpeedResponseResponseBody]
             OK response.
 
         Examples
@@ -198,12 +201,18 @@ class AsyncLocationAndSpeedClient:
 
 
         async def main() -> None:
-            await client.assets.location_and_speed.stream()
+            response = await client.assets.location_and_speed.stream()
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.stream(
+        return await self._raw_client.stream(
             after=after,
             limit=limit,
             start_time=start_time,
@@ -215,4 +224,3 @@ class AsyncLocationAndSpeedClient:
             include_external_ids=include_external_ids,
             request_options=request_options,
         )
-        return _response.data