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

samsara/vehicles/client.py

@@ -3,19 +3,19 @@
 import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
 from ..core.request_options import RequestOptions
 from ..types.attribute_tiny import AttributeTiny
 from ..types.gross_vehicle_weight import GrossVehicleWeight
 from ..types.user_identifier_serial import UserIdentifierSerial
 from ..types.vehicle_regulation_mode import VehicleRegulationMode
 from ..types.vehicle_response import VehicleResponse
+from ..types.vehicle_response_object_response_body import VehicleResponseObjectResponseBody
 from ..types.vehicle_type import VehicleType
-from ..types.vehicles_list_vehicles_response_body import VehiclesListVehiclesResponseBody
 from .immobilizer.client import AsyncImmobilizerClient, ImmobilizerClient
 from .locations.client import AsyncLocationsClient, LocationsClient
 from .raw_client import AsyncRawVehiclesClient, RawVehiclesClient
 from .stats.client import AsyncStatsClient, StatsClient
-from .tachograph_files.client import AsyncTachographFilesClient, TachographFilesClient
 from .types.update_vehicle_request_aux_input_type_1 import UpdateVehicleRequestAuxInputType1
 from .types.update_vehicle_request_aux_input_type_2 import UpdateVehicleRequestAuxInputType2
 from .types.update_vehicle_request_aux_input_type_3 import UpdateVehicleRequestAuxInputType3
@@ -46,8 +46,6 @@ class VehiclesClient:
 
         self.stats = StatsClient(client_wrapper=client_wrapper)
 
-        self.tachograph_files = TachographFilesClient(client_wrapper=client_wrapper)
-
     @property
     def with_raw_response(self) -> RawVehiclesClient:
         """
@@ -67,10 +65,11 @@ class VehiclesClient:
         parent_tag_ids: typing.Optional[str] = None,
         tag_ids: typing.Optional[str] = None,
         attribute_value_ids: typing.Optional[str] = None,
+        attributes: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         updated_after_time: typing.Optional[str] = None,
         created_after_time: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehiclesListVehiclesResponseBody:
+    ) -> SyncPager[VehicleResponseObjectResponseBody]:
         """
         Returns a list of all vehicles.
 
@@ -98,6 +97,9 @@ class VehiclesClient:
         attribute_value_ids : typing.Optional[str]
             A filter on the data based on this comma-separated list of attribute value IDs. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributeValueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544`
 
+        attributes : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data to return entities having given attributes using name-value pair, separated by semicolon. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributes=ExampleAttributeName:some_value&attributes=SomeOtherAttr:123`
+
         updated_after_time : typing.Optional[str]
              A filter on data to have an updated at time after or equal to this specified time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
 
@@ -109,7 +111,7 @@ class VehiclesClient:
 
         Returns
         -------
-        VehiclesListVehiclesResponseBody
+        SyncPager[VehicleResponseObjectResponseBody]
             OK response.
 
         Examples
@@ -119,19 +121,24 @@ class VehiclesClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.vehicles.list()
+        response = client.vehicles.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(
             limit=limit,
             after=after,
             parent_tag_ids=parent_tag_ids,
             tag_ids=tag_ids,
             attribute_value_ids=attribute_value_ids,
+            attributes=attributes,
             updated_after_time=updated_after_time,
             created_after_time=created_after_time,
             request_options=request_options,
         )
-        return _response.data
 
     def get(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> VehicleResponse:
         """
@@ -362,8 +369,6 @@ class AsyncVehiclesClient:
 
         self.stats = AsyncStatsClient(client_wrapper=client_wrapper)
 
-        self.tachograph_files = AsyncTachographFilesClient(client_wrapper=client_wrapper)
-
     @property
     def with_raw_response(self) -> AsyncRawVehiclesClient:
         """
@@ -383,10 +388,11 @@ class AsyncVehiclesClient:
         parent_tag_ids: typing.Optional[str] = None,
         tag_ids: typing.Optional[str] = None,
         attribute_value_ids: typing.Optional[str] = None,
+        attributes: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         updated_after_time: typing.Optional[str] = None,
         created_after_time: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehiclesListVehiclesResponseBody:
+    ) -> AsyncPager[VehicleResponseObjectResponseBody]:
         """
         Returns a list of all vehicles.
 
@@ -414,6 +420,9 @@ class AsyncVehiclesClient:
         attribute_value_ids : typing.Optional[str]
             A filter on the data based on this comma-separated list of attribute value IDs. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributeValueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544`
 
+        attributes : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data to return entities having given attributes using name-value pair, separated by semicolon. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributes=ExampleAttributeName:some_value&attributes=SomeOtherAttr:123`
+
         updated_after_time : typing.Optional[str]
              A filter on data to have an updated at time after or equal to this specified time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
 
@@ -425,7 +434,7 @@ class AsyncVehiclesClient:
 
         Returns
         -------
-        VehiclesListVehiclesResponseBody
+        AsyncPager[VehicleResponseObjectResponseBody]
             OK response.
 
         Examples
@@ -440,22 +449,28 @@ class AsyncVehiclesClient:
 
 
         async def main() -> None:
-            await client.vehicles.list()
+            response = await client.vehicles.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(
             limit=limit,
             after=after,
             parent_tag_ids=parent_tag_ids,
             tag_ids=tag_ids,
             attribute_value_ids=attribute_value_ids,
+            attributes=attributes,
             updated_after_time=updated_after_time,
             created_after_time=created_after_time,
             request_options=request_options,
         )
-        return _response.data
 
     async def get(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> VehicleResponse:
         """

samsara/vehicles/immobilizer/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.engine_immobilizer_get_engine_immobilizer_states_response_body import (
-    EngineImmobilizerGetEngineImmobilizerStatesResponseBody,
-)
+from ...types.engine_immobilizer_state_response_body import EngineImmobilizerStateResponseBody
 from .raw_client import AsyncRawImmobilizerClient, RawImmobilizerClient
 
 
@@ -33,7 +32,7 @@ class ImmobilizerClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> EngineImmobilizerGetEngineImmobilizerStatesResponseBody:
+    ) -> SyncPager[EngineImmobilizerStateResponseBody]:
         """
         Get the engine immobilizer states of the queried vehicles. If a vehicle has never had an engine immobilizer connected, there won't be any state returned for that vehicle.
 
@@ -63,7 +62,7 @@ class ImmobilizerClient:
 
         Returns
         -------
-        EngineImmobilizerGetEngineImmobilizerStatesResponseBody
+        SyncPager[EngineImmobilizerStateResponseBody]
             OK response.
 
         Examples
@@ -73,19 +72,23 @@ class ImmobilizerClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.vehicles.immobilizer.stream(
+        response = client.vehicles.immobilizer.stream(
             vehicle_ids="vehicleIds",
             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(
             vehicle_ids=vehicle_ids,
             start_time=start_time,
             end_time=end_time,
             after=after,
             request_options=request_options,
         )
-        return _response.data
 
 
 class AsyncImmobilizerClient:
@@ -111,7 +114,7 @@ class AsyncImmobilizerClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> EngineImmobilizerGetEngineImmobilizerStatesResponseBody:
+    ) -> AsyncPager[EngineImmobilizerStateResponseBody]:
         """
         Get the engine immobilizer states of the queried vehicles. If a vehicle has never had an engine immobilizer connected, there won't be any state returned for that vehicle.
 
@@ -141,7 +144,7 @@ class AsyncImmobilizerClient:
 
         Returns
         -------
-        EngineImmobilizerGetEngineImmobilizerStatesResponseBody
+        AsyncPager[EngineImmobilizerStateResponseBody]
             OK response.
 
         Examples
@@ -156,19 +159,24 @@ class AsyncImmobilizerClient:
 
 
         async def main() -> None:
-            await client.vehicles.immobilizer.stream(
+            response = await client.vehicles.immobilizer.stream(
                 vehicle_ids="vehicleIds",
                 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(
             vehicle_ids=vehicle_ids,
             start_time=start_time,
             end_time=end_time,
             after=after,
             request_options=request_options,
         )
-        return _response.data

samsara/vehicles/immobilizer/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
@@ -20,6 +20,7 @@ from ...errors.unauthorized_error import UnauthorizedError
 from ...types.engine_immobilizer_get_engine_immobilizer_states_response_body import (
     EngineImmobilizerGetEngineImmobilizerStatesResponseBody,
 )
+from ...types.engine_immobilizer_state_response_body import EngineImmobilizerStateResponseBody
 
 
 class RawImmobilizerClient:
@@ -34,7 +35,7 @@ class RawImmobilizerClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[EngineImmobilizerGetEngineImmobilizerStatesResponseBody]:
+    ) -> SyncPager[EngineImmobilizerStateResponseBody]:
         """
         Get the engine immobilizer states of the queried vehicles. If a vehicle has never had an engine immobilizer connected, there won't be any state returned for that vehicle.
 
@@ -64,7 +65,7 @@ class RawImmobilizerClient:
 
         Returns
         -------
-        HttpResponse[EngineImmobilizerGetEngineImmobilizerStatesResponseBody]
+        SyncPager[EngineImmobilizerStateResponseBody]
             OK response.
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -80,14 +81,29 @@ class RawImmobilizerClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     EngineImmobilizerGetEngineImmobilizerStatesResponseBody,
                     parse_obj_as(
                         type_=EngineImmobilizerGetEngineImmobilizerStatesResponseBody,  # 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(
+                        vehicle_ids=vehicle_ids,
+                        start_time=start_time,
+                        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),
@@ -205,7 +221,7 @@ class AsyncRawImmobilizerClient:
         end_time: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[EngineImmobilizerGetEngineImmobilizerStatesResponseBody]:
+    ) -> AsyncPager[EngineImmobilizerStateResponseBody]:
         """
         Get the engine immobilizer states of the queried vehicles. If a vehicle has never had an engine immobilizer connected, there won't be any state returned for that vehicle.
 
@@ -235,7 +251,7 @@ class AsyncRawImmobilizerClient:
 
         Returns
         -------
-        AsyncHttpResponse[EngineImmobilizerGetEngineImmobilizerStatesResponseBody]
+        AsyncPager[EngineImmobilizerStateResponseBody]
             OK response.
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -251,14 +267,32 @@ class AsyncRawImmobilizerClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     EngineImmobilizerGetEngineImmobilizerStatesResponseBody,
                     parse_obj_as(
                         type_=EngineImmobilizerGetEngineImmobilizerStatesResponseBody,  # 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(
+                            vehicle_ids=vehicle_ids,
+                            start_time=start_time,
+                            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/vehicles/locations/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.vehicle_locations_list_response import VehicleLocationsListResponse
-from ...types.vehicle_locations_response import VehicleLocationsResponse
+from ...types.vehicle_locations_list_response_data import VehicleLocationsListResponseData
+from ...types.vehicle_locations_response_data import VehicleLocationsResponseData
 from .raw_client import AsyncRawLocationsClient, RawLocationsClient
 
 
@@ -33,7 +34,7 @@ class LocationsClient:
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehicleLocationsResponse:
+    ) -> SyncPager[VehicleLocationsResponseData]:
         """
         ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestats) instead.***
 
@@ -67,7 +68,7 @@ class LocationsClient:
 
         Returns
         -------
-        VehicleLocationsResponse
+        SyncPager[VehicleLocationsResponseData]
             List of the most recent locations for the specified vehicles.
 
         Examples
@@ -77,9 +78,14 @@ class LocationsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.vehicles.locations.list()
+        response = client.vehicles.locations.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(
             after=after,
             time=time,
             parent_tag_ids=parent_tag_ids,
@@ -87,7 +93,6 @@ class LocationsClient:
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data
 
     def feed(
         self,
@@ -97,7 +102,7 @@ class LocationsClient:
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehicleLocationsListResponse:
+    ) -> SyncPager[VehicleLocationsListResponseData]:
         """
         ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestatsfeed) instead.***
 
@@ -134,7 +139,7 @@ class LocationsClient:
 
         Returns
         -------
-        VehicleLocationsListResponse
+        SyncPager[VehicleLocationsListResponseData]
             List of locations events for the specified vehicles.
 
         Examples
@@ -144,16 +149,20 @@ class LocationsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.vehicles.locations.feed()
+        response = client.vehicles.locations.feed()
+        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.feed(
+        return self._raw_client.feed(
             after=after,
             parent_tag_ids=parent_tag_ids,
             tag_ids=tag_ids,
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data
 
     def history(
         self,
@@ -165,7 +174,7 @@ class LocationsClient:
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehicleLocationsListResponse:
+    ) -> SyncPager[VehicleLocationsListResponseData]:
         """
         ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestatshistory) instead.***
 
@@ -202,7 +211,7 @@ class LocationsClient:
 
         Returns
         -------
-        VehicleLocationsListResponse
+        SyncPager[VehicleLocationsListResponseData]
             List of all locations for the specified vehicles and time range.
 
         Examples
@@ -212,12 +221,17 @@ class LocationsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.vehicles.locations.history(
+        response = client.vehicles.locations.history(
             start_time="startTime",
             end_time="endTime",
         )
+        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.history(
+        return self._raw_client.history(
             start_time=start_time,
             end_time=end_time,
             after=after,
@@ -226,7 +240,6 @@ class LocationsClient:
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data
 
 
 class AsyncLocationsClient:
@@ -253,7 +266,7 @@ class AsyncLocationsClient:
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehicleLocationsResponse:
+    ) -> AsyncPager[VehicleLocationsResponseData]:
         """
         ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestats) instead.***
 
@@ -287,7 +300,7 @@ class AsyncLocationsClient:
 
         Returns
         -------
-        VehicleLocationsResponse
+        AsyncPager[VehicleLocationsResponseData]
             List of the most recent locations for the specified vehicles.
 
         Examples
@@ -302,12 +315,18 @@ class AsyncLocationsClient:
 
 
         async def main() -> None:
-            await client.vehicles.locations.list()
+            response = await client.vehicles.locations.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(
             after=after,
             time=time,
             parent_tag_ids=parent_tag_ids,
@@ -315,7 +334,6 @@ class AsyncLocationsClient:
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data
 
     async def feed(
         self,
@@ -325,7 +343,7 @@ class AsyncLocationsClient:
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehicleLocationsListResponse:
+    ) -> AsyncPager[VehicleLocationsListResponseData]:
         """
         ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestatsfeed) instead.***
 
@@ -362,7 +380,7 @@ class AsyncLocationsClient:
 
         Returns
         -------
-        VehicleLocationsListResponse
+        AsyncPager[VehicleLocationsListResponseData]
             List of locations events for the specified vehicles.
 
         Examples
@@ -377,19 +395,24 @@ class AsyncLocationsClient:
 
 
         async def main() -> None:
-            await client.vehicles.locations.feed()
+            response = await client.vehicles.locations.feed()
+            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.feed(
+        return await self._raw_client.feed(
             after=after,
             parent_tag_ids=parent_tag_ids,
             tag_ids=tag_ids,
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data
 
     async def history(
         self,
@@ -401,7 +424,7 @@ class AsyncLocationsClient:
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> VehicleLocationsListResponse:
+    ) -> AsyncPager[VehicleLocationsListResponseData]:
         """
         ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestatshistory) instead.***
 
@@ -438,7 +461,7 @@ class AsyncLocationsClient:
 
         Returns
         -------
-        VehicleLocationsListResponse
+        AsyncPager[VehicleLocationsListResponseData]
             List of all locations for the specified vehicles and time range.
 
         Examples
@@ -453,15 +476,21 @@ class AsyncLocationsClient:
 
 
         async def main() -> None:
-            await client.vehicles.locations.history(
+            response = await client.vehicles.locations.history(
                 start_time="startTime",
                 end_time="endTime",
             )
+            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.history(
+        return await self._raw_client.history(
             start_time=start_time,
             end_time=end_time,
             after=after,
@@ -470,4 +499,3 @@ class AsyncLocationsClient:
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data