wavix-python-sdk 1.0.0__py3-none-any.whl

wavix/sms_and_mms/messages/raw_client.py

@@ -0,0 +1,793 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+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.jsonable_encoder import encode_path_param
+from ...core.parse_error import ParsingError
+from ...core.pydantic_utilities import parse_obj_as
+from ...core.request_options import RequestOptions
+from ...core.serialization import convert_and_respect_annotation_metadata
+from ...errors.bad_request_error import BadRequestError
+from ...errors.forbidden_error import ForbiddenError
+from ...errors.not_found_error import NotFoundError
+from ...types.message_body import MessageBody
+from ...types.message_delivery_status import MessageDeliveryStatus
+from ...types.send_messages_response import SendMessagesResponse
+from .types.get_messages_response import GetMessagesResponse
+from .types.list_all_messages_request_message_type import ListAllMessagesRequestMessageType
+from .types.list_messages_request_message_type import ListMessagesRequestMessageType
+from .types.list_messages_response import ListMessagesResponse
+from pydantic import ValidationError
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawMessagesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list(
+        self,
+        *,
+        type: str,
+        sent_after: typing.Optional[str] = None,
+        sent_before: typing.Optional[str] = None,
+        from_: typing.Optional[str] = None,
+        to: typing.Optional[str] = None,
+        status: typing.Optional[MessageDeliveryStatus] = None,
+        tag: typing.Optional[str] = None,
+        message_type: typing.Optional[ListMessagesRequestMessageType] = None,
+        page: typing.Optional[int] = None,
+        per_page: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[ListMessagesResponse]:
+        """
+        Returns a paginated list of SMS and MMS messages for the authenticated account, filtered by direction, date, and other criteria.
+
+        Parameters
+        ----------
+        type : str
+            Filters messages by direction. One of `inbound` (messages received by the account) or `outbound` (messages sent by the account).
+
+        sent_after : typing.Optional[str]
+            Returns messages sent on or after this date, in `YYYY-MM-DD` format.
+
+        sent_before : typing.Optional[str]
+            Returns messages sent on or before this date, in `YYYY-MM-DD` format.
+
+        from_ : typing.Optional[str]
+            Filters by message sender. For `outbound` messages, the Sender ID used to send the message; for `inbound` messages, the originating phone number.
+
+        to : typing.Optional[str]
+            Filters by message recipient. For `outbound` messages, the destination phone number; for `inbound` messages, an SMS-enabled number on the Wavix platform.
+
+        status : typing.Optional[MessageDeliveryStatus]
+            Filters messages by delivery status. Accepts a `MessageDeliveryStatus` value.
+
+        tag : typing.Optional[str]
+            Filters messages by `tag`. Supported for outbound messages only.
+
+        message_type : typing.Optional[ListMessagesRequestMessageType]
+            Filters messages by type. One of `sms` (text message) or `mms` (multimedia message).
+
+        page : typing.Optional[int]
+            Page number to retrieve. Default `1`.
+
+        per_page : typing.Optional[int]
+            Number of records to return per page. Default `25`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[ListMessagesResponse]
+            Returns a paginated list of messages.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v3/messages",
+            method="GET",
+            params={
+                "sent_after": sent_after,
+                "sent_before": sent_before,
+                "type": type,
+                "from": from_,
+                "to": to,
+                "status": status,
+                "tag": tag,
+                "message_type": message_type,
+                "page": page,
+                "per_page": per_page,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    ListMessagesResponse,
+                    parse_obj_as(
+                        type_=ListMessagesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def send(
+        self,
+        *,
+        from_: str,
+        to: str,
+        message_body: MessageBody,
+        callback_url: typing.Optional[str] = OMIT,
+        validity: typing.Optional[int] = OMIT,
+        tag: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[SendMessagesResponse]:
+        """
+        Sends an SMS or MMS message. MMS is supported for U.S. numbers only. Track delivery using the returned `message_id` and the message status callback.
+        **Rate limit**: 20 messages per phone number in 24 hours.
+
+        Parameters
+        ----------
+        from_ : str
+            Sender ID. Numeric or alphanumeric.
+
+        to : str
+            Recipient phone number.
+
+        message_body : MessageBody
+
+        callback_url : typing.Optional[str]
+            Callback URL for delivery reports.
+
+        validity : typing.Optional[int]
+            Message validity period in seconds. Delivery attempts stop after this period expires.
+
+        tag : typing.Optional[str]
+            Tag to group messages, such as for a specific campaign.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[SendMessagesResponse]
+            Returns the submitted message with its `message_id` and initial status.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v3/messages",
+            method="POST",
+            json={
+                "from": from_,
+                "to": to,
+                "message_body": convert_and_respect_annotation_metadata(
+                    object_=message_body, annotation=MessageBody, direction="write"
+                ),
+                "callback_url": callback_url,
+                "validity": validity,
+                "tag": tag,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    SendMessagesResponse,
+                    parse_obj_as(
+                        type_=SendMessagesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def get(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[GetMessagesResponse]:
+        """
+        Returns the SMS or MMS message identified by `id`, including its delivery status and content.
+
+        Parameters
+        ----------
+        id : str
+            The unique ID of the message.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[GetMessagesResponse]
+            Returns the message.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v3/messages/{encode_path_param(id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetMessagesResponse,
+                    parse_obj_as(
+                        type_=GetMessagesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def list_all(
+        self,
+        *,
+        type: str,
+        sent_after: typing.Optional[str] = None,
+        sent_before: typing.Optional[str] = None,
+        from_: typing.Optional[str] = None,
+        to: typing.Optional[str] = None,
+        status: typing.Optional[MessageDeliveryStatus] = None,
+        tag: typing.Optional[str] = None,
+        message_type: typing.Optional[ListAllMessagesRequestMessageType] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[str]:
+        """
+        Streams matching SMS and MMS messages as newline-delimited JSON (NDJSON), one message per line, for bulk export.
+
+        Parameters
+        ----------
+        type : str
+            Filters messages by direction. One of `inbound` (messages received by the account) or `outbound` (messages sent by the account).
+
+        sent_after : typing.Optional[str]
+            Returns messages sent on or after this timestamp, in `YYYY-MM-DDTHH:MM:SS` format.
+
+        sent_before : typing.Optional[str]
+            Returns messages sent on or before this timestamp, in `YYYY-MM-DDTHH:MM:SS` format.
+
+        from_ : typing.Optional[str]
+            Filters by message sender. For `outbound` messages, the Sender ID used to send the message; for `inbound` messages, the originating phone number.
+
+        to : typing.Optional[str]
+            Filters by message recipient. For `outbound` messages, the destination phone number; for `inbound` messages, the SMS-enabled number that received the message.
+
+        status : typing.Optional[MessageDeliveryStatus]
+            Filters messages by delivery status. Accepts a `MessageDeliveryStatus` value.
+
+        tag : typing.Optional[str]
+            Filters messages by `tag`. Supported for outbound messages only.
+
+        message_type : typing.Optional[ListAllMessagesRequestMessageType]
+            Filters messages by type. One of `sms` (text message) or `mms` (multimedia message).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[str]
+            Returns an NDJSON stream of messages, one per line.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v3/messages/all",
+            method="GET",
+            params={
+                "sent_after": sent_after,
+                "sent_before": sent_before,
+                "type": type,
+                "from": from_,
+                "to": to,
+                "status": status,
+                "tag": tag,
+                "message_type": message_type,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    str,
+                    parse_obj_as(
+                        type_=str,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawMessagesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
+        self,
+        *,
+        type: str,
+        sent_after: typing.Optional[str] = None,
+        sent_before: typing.Optional[str] = None,
+        from_: typing.Optional[str] = None,
+        to: typing.Optional[str] = None,
+        status: typing.Optional[MessageDeliveryStatus] = None,
+        tag: typing.Optional[str] = None,
+        message_type: typing.Optional[ListMessagesRequestMessageType] = None,
+        page: typing.Optional[int] = None,
+        per_page: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[ListMessagesResponse]:
+        """
+        Returns a paginated list of SMS and MMS messages for the authenticated account, filtered by direction, date, and other criteria.
+
+        Parameters
+        ----------
+        type : str
+            Filters messages by direction. One of `inbound` (messages received by the account) or `outbound` (messages sent by the account).
+
+        sent_after : typing.Optional[str]
+            Returns messages sent on or after this date, in `YYYY-MM-DD` format.
+
+        sent_before : typing.Optional[str]
+            Returns messages sent on or before this date, in `YYYY-MM-DD` format.
+
+        from_ : typing.Optional[str]
+            Filters by message sender. For `outbound` messages, the Sender ID used to send the message; for `inbound` messages, the originating phone number.
+
+        to : typing.Optional[str]
+            Filters by message recipient. For `outbound` messages, the destination phone number; for `inbound` messages, an SMS-enabled number on the Wavix platform.
+
+        status : typing.Optional[MessageDeliveryStatus]
+            Filters messages by delivery status. Accepts a `MessageDeliveryStatus` value.
+
+        tag : typing.Optional[str]
+            Filters messages by `tag`. Supported for outbound messages only.
+
+        message_type : typing.Optional[ListMessagesRequestMessageType]
+            Filters messages by type. One of `sms` (text message) or `mms` (multimedia message).
+
+        page : typing.Optional[int]
+            Page number to retrieve. Default `1`.
+
+        per_page : typing.Optional[int]
+            Number of records to return per page. Default `25`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[ListMessagesResponse]
+            Returns a paginated list of messages.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v3/messages",
+            method="GET",
+            params={
+                "sent_after": sent_after,
+                "sent_before": sent_before,
+                "type": type,
+                "from": from_,
+                "to": to,
+                "status": status,
+                "tag": tag,
+                "message_type": message_type,
+                "page": page,
+                "per_page": per_page,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    ListMessagesResponse,
+                    parse_obj_as(
+                        type_=ListMessagesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def send(
+        self,
+        *,
+        from_: str,
+        to: str,
+        message_body: MessageBody,
+        callback_url: typing.Optional[str] = OMIT,
+        validity: typing.Optional[int] = OMIT,
+        tag: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[SendMessagesResponse]:
+        """
+        Sends an SMS or MMS message. MMS is supported for U.S. numbers only. Track delivery using the returned `message_id` and the message status callback.
+        **Rate limit**: 20 messages per phone number in 24 hours.
+
+        Parameters
+        ----------
+        from_ : str
+            Sender ID. Numeric or alphanumeric.
+
+        to : str
+            Recipient phone number.
+
+        message_body : MessageBody
+
+        callback_url : typing.Optional[str]
+            Callback URL for delivery reports.
+
+        validity : typing.Optional[int]
+            Message validity period in seconds. Delivery attempts stop after this period expires.
+
+        tag : typing.Optional[str]
+            Tag to group messages, such as for a specific campaign.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[SendMessagesResponse]
+            Returns the submitted message with its `message_id` and initial status.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v3/messages",
+            method="POST",
+            json={
+                "from": from_,
+                "to": to,
+                "message_body": convert_and_respect_annotation_metadata(
+                    object_=message_body, annotation=MessageBody, direction="write"
+                ),
+                "callback_url": callback_url,
+                "validity": validity,
+                "tag": tag,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    SendMessagesResponse,
+                    parse_obj_as(
+                        type_=SendMessagesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def get(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[GetMessagesResponse]:
+        """
+        Returns the SMS or MMS message identified by `id`, including its delivery status and content.
+
+        Parameters
+        ----------
+        id : str
+            The unique ID of the message.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[GetMessagesResponse]
+            Returns the message.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v3/messages/{encode_path_param(id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetMessagesResponse,
+                    parse_obj_as(
+                        type_=GetMessagesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def list_all(
+        self,
+        *,
+        type: str,
+        sent_after: typing.Optional[str] = None,
+        sent_before: typing.Optional[str] = None,
+        from_: typing.Optional[str] = None,
+        to: typing.Optional[str] = None,
+        status: typing.Optional[MessageDeliveryStatus] = None,
+        tag: typing.Optional[str] = None,
+        message_type: typing.Optional[ListAllMessagesRequestMessageType] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[str]:
+        """
+        Streams matching SMS and MMS messages as newline-delimited JSON (NDJSON), one message per line, for bulk export.
+
+        Parameters
+        ----------
+        type : str
+            Filters messages by direction. One of `inbound` (messages received by the account) or `outbound` (messages sent by the account).
+
+        sent_after : typing.Optional[str]
+            Returns messages sent on or after this timestamp, in `YYYY-MM-DDTHH:MM:SS` format.
+
+        sent_before : typing.Optional[str]
+            Returns messages sent on or before this timestamp, in `YYYY-MM-DDTHH:MM:SS` format.
+
+        from_ : typing.Optional[str]
+            Filters by message sender. For `outbound` messages, the Sender ID used to send the message; for `inbound` messages, the originating phone number.
+
+        to : typing.Optional[str]
+            Filters by message recipient. For `outbound` messages, the destination phone number; for `inbound` messages, the SMS-enabled number that received the message.
+
+        status : typing.Optional[MessageDeliveryStatus]
+            Filters messages by delivery status. Accepts a `MessageDeliveryStatus` value.
+
+        tag : typing.Optional[str]
+            Filters messages by `tag`. Supported for outbound messages only.
+
+        message_type : typing.Optional[ListAllMessagesRequestMessageType]
+            Filters messages by type. One of `sms` (text message) or `mms` (multimedia message).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[str]
+            Returns an NDJSON stream of messages, one per line.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v3/messages/all",
+            method="GET",
+            params={
+                "sent_after": sent_after,
+                "sent_before": sent_before,
+                "type": type,
+                "from": from_,
+                "to": to,
+                "status": status,
+                "tag": tag,
+                "message_type": message_type,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    str,
+                    parse_obj_as(
+                        type_=str,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)