python-amazon-sp-api 1.9.18__py3-none-any.whl → 2.0.7__py3-none-any.whl

sp_api/asyncio/api/fba_inbound_eligibility/__init__.py

@@ -0,0 +1,5 @@
+from .fba_inbound_eligibility import FbaInboundEligibility
+
+__all__ = [
+    "FbaInboundEligibility",
+]

sp_api/asyncio/api/fba_inbound_eligibility/fba_inbound_eligibility.py

@@ -0,0 +1,96 @@
+import urllib.parse
+
+from sp_api.base import (
+    ApiResponse,
+    IneligibilityReasonList,
+    fill_query_params,
+    sp_endpoint,
+)
+from sp_api.asyncio.base import AsyncBaseClient
+
+
+class FbaInboundEligibility(AsyncBaseClient):
+    """
+    FbaInboundEligibility SP-API Client
+    :link:
+
+    With the FBA Inbound Eligibility API, you can build applications that let sellers get eligibility previews for items before shipping them to Amazon's fulfillment centers. With this API you can find out if an item is eligible for inbound shipment to Amazon's fulfillment centers in a specific marketplace. You can also find out if an item is eligible for using the manufacturer barcode for FBA inventory tracking. Sellers can use this information to inform their decisions about which items to ship Amazon's fulfillment centers.
+    """
+
+    @sp_endpoint("/fba/inbound/v1/eligibility/itemPreview", method="GET")
+    async def get_item_eligibility_preview(self, **kwargs) -> ApiResponse:
+        """
+        get_item_eligibility_preview(self, **kwargs) -> ApiResponse
+
+        This operation gets an eligibility preview for an item that you specify. You can specify the type of eligibility preview that you want (INBOUND or COMMINGLING). For INBOUND previews, you can specify the marketplace in which you want to determine the item's eligibility.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       1
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            key marketplaceIds:array |  The identifier for the marketplace in which you want to determine eligibility. Required only when program=INBOUND.
+            key asin:string | * REQUIRED The ASIN of the item for which you want an eligibility preview.
+            key program:string | * REQUIRED The program that you want to check eligibility against.
+
+
+        Returns:
+            ApiResponse:
+        """
+        return await self._request(kwargs.pop("path"), params=kwargs)
+
+    @sp_endpoint("/fba/inbound/v1/eligibility/itemPreview", method="GET")
+    async def get_item_eligibility_preview_extended(self, **kwargs) -> ApiResponse:
+        """
+        get_item_eligibility_preview_extended(self, **kwargs) -> ApiResponse
+
+        This operation gets an eligibility preview for an item that you specify. You can specify the type of eligibility preview that you want (INBOUND or COMMINGLING). For INBOUND previews, you can specify the marketplace in which you want to determine the item's eligibility.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       1
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            key marketplaceIds:array |  The identifier for the marketplace in which you want to determine eligibility. Required only when program=INBOUND.
+            key asin:string | * REQUIRED The ASIN of the item for which you want an eligibility preview.
+            key program:string | * REQUIRED The program that you want to check eligibility against.
+
+
+        Returns:
+            ApiResponse:
+        """
+
+        api_response = await self._request(kwargs.pop("path"), params=kwargs)
+
+        if (
+            api_response.payload.get("ineligibilityReasonList")
+            and api_response.payload.get("isEligibleForProgram") is False
+        ):
+            ineligibility_list = api_response.payload.get("ineligibilityReasonList")
+            errors = []
+            for ineligibility_option in ineligibility_list:
+                try:
+                    errors.append(
+                        ineligibility_option
+                        + ": "
+                        + IneligibilityReasonList[ineligibility_option].value
+                    )
+                except KeyError as error:
+                    errors.append(error)
+            api_response.payload.update({"ineligibilityReasonListMessage": errors})
+
+        return api_response

sp_api/asyncio/api/fba_small_and_light/__init__.py

@@ -0,0 +1,5 @@
+from .fba_small_and_light import FbaSmallAndLight
+
+__all__ = [
+    "FbaSmallAndLight",
+]

sp_api/asyncio/api/fba_small_and_light/fba_small_and_light.py

@@ -0,0 +1,213 @@
+import urllib.parse
+
+from sp_api.base import ApiResponse, deprecated, fill_query_params, sp_endpoint
+from sp_api.asyncio.base import AsyncBaseClient
+
+
+class FbaSmallAndLight(AsyncBaseClient):
+    """
+    FbaSmallAndLight SP-API Client
+    :link:
+
+    The Selling Partner API for FBA Small and Light lets you help sellers manage their listings in the Small and Light program. The program reduces the cost of fulfilling orders for small and lightweight FBA inventory. You can enroll or remove items from the program and check item eligibility and enrollment status. You can also preview the estimated program fees charged to a seller for items sold while enrolled in the program.
+    """
+
+    @deprecated
+    async def get_small_and_light_enrollment_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
+        return await self.get_small_and_light_enrollment_by_seller_sku(
+            sellerSKU, **kwargs
+        )
+
+    @sp_endpoint("/fba/smallAndLight/v1/enrollments/{}", method="GET")
+    async def get_small_and_light_enrollment_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
+        """
+        get_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
+
+        Returns the Small and Light enrollment status for the item indicated by the specified seller SKU in the specified marketplace.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        2                                       10
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            seller_sku:string | * REQUIRED The seller SKU that identifies the item.
+            key marketplaceIds:array | * REQUIRED The marketplace for which the enrollment status is retrieved. Note: Accepts a single marketplace only.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku), params=kwargs
+        )
+
+    @deprecated
+    async def put_small_and_light_enrollment_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
+        return await self.put_small_and_light_enrollment_by_seller_sku(
+            sellerSKU, **kwargs
+        )
+
+    @sp_endpoint("/fba/smallAndLight/v1/enrollments/{}", method="PUT")
+    async def put_small_and_light_enrollment_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
+        """
+        put_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
+
+        Enrolls the item indicated by the specified seller SKU in the Small and Light program in the specified marketplace. If the item is not eligible, the ineligibility reasons are returned.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        2                                       5
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            seller_sku:string | * REQUIRED The seller SKU that identifies the item.
+            key marketplaceIds:array | * REQUIRED The marketplace in which to enroll the item. Note: Accepts a single marketplace only.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku),
+            params={
+                "marketplaceIds": kwargs.get("marketplaceIds", self.marketplace_id)
+            },
+        )
+
+    @deprecated
+    async def delete_small_and_light_enrollment_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
+        return await self.delete_small_and_light_enrollment_by_seller_sku(
+            sellerSKU, **kwargs
+        )
+
+    @sp_endpoint("/fba/smallAndLight/v1/enrollments/{}", method="DELETE")
+    async def delete_small_and_light_enrollment_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
+        """
+        delete_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
+
+        Removes the item indicated by the specified seller SKU from the Small and Light program in the specified marketplace. If the item is not eligible for disenrollment, the ineligibility reasons are returned.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        2                                       5
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            seller_sku:string | * REQUIRED The seller SKU that identifies the item.
+            key marketplaceIds:array | * REQUIRED The marketplace in which to remove the item from the Small and Light program. Note: Accepts a single marketplace only.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku), data=kwargs
+        )
+
+    @deprecated
+    async def get_small_and_light_eligibility_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
+        return await self.get_small_and_light_eligibility_by_seller_sku(
+            sellerSKU, **kwargs
+        )
+
+    @sp_endpoint("/fba/smallAndLight/v1/eligibilities/{}", method="GET")
+    async def get_small_and_light_eligibility_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
+        """
+        get_small_and_light_eligibility_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
+
+        Returns the Small and Light program eligibility status of the item indicated by the specified seller SKU in the specified marketplace. If the item is not eligible, the ineligibility reasons are returned.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        2                                       10
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            seller_sku:string | * REQUIRED The seller SKU that identifies the item.
+            key marketplaceIds:array | * REQUIRED The marketplace for which the eligibility status is retrieved. NOTE: Accepts a single marketplace only.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku), params=kwargs
+        )
+
+    @sp_endpoint("/fba/smallAndLight/v1/feePreviews", method="POST")
+    async def get_small_and_light_fee_preview(self, **kwargs) -> ApiResponse:
+        """
+        get_small_and_light_fee_preview(self, **kwargs) -> ApiResponse
+
+        Returns the Small and Light fee estimates for the specified items. You must include a marketplaceId parameter to retrieve the proper fee estimates for items to be sold in that marketplace. The ordering of items in the response will mirror the order of the items in the request. Duplicate ASIN/price combinations are removed.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       3
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            body:  REQUIRED
+            {
+              "marketplaceId": "string",
+              "items": [
+                {
+                  "asin": "string",
+                  "price": {
+                    "currencyCode": "string",
+                    "amount": 0
+                  }
+                }
+              ]
+            }
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(kwargs.pop("path"), data=kwargs)

sp_api/asyncio/api/feeds/feeds.py

@@ -0,0 +1,260 @@
+import zlib
+
+from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
+from sp_api.asyncio.base import AsyncBaseClient
+from sp_api.util import should_add_marketplace
+
+
+class Feeds(AsyncBaseClient):
+    """
+    Feeds SP-API Client
+    :link:
+
+    The Selling Partner API for Feeds lets you upload data to Amazon on behalf of a selling partner.
+    """
+
+    @sp_endpoint("/feeds/2021-06-30/feeds", method="GET")
+    async def get_feeds(self, **kwargs) -> ApiResponse:
+        """
+        get_feeds(self, **kwargs) -> ApiResponse
+
+        Returns feed details for the feeds that match the filters that you specify.
+
+        Args:
+            key feedTypes:array |  A list of feed types used to filter feeds. When feedTypes is provided, the other filter parameters (processingStatuses, marketplaceIds, createdSince, createdUntil) and pageSize may also be provided. Either feedTypes or nextToken is required.
+            key marketplaceIds:array |  A list of marketplace identifiers used to filter feeds. The feeds returned will match at least one of the marketplaces that you specify.
+            key pageSize:integer |  The maximum number of feeds to return in a single call.
+            key processingStatuses:array |  A list of processing statuses used to filter feeds.
+            key createdSince:string |  The earliest feed creation date and time for feeds included in the response, in ISO 8601 format. The default is 90 days ago. Feeds are retained for a maximum of 90 days.
+            key createdUntil:string |  The latest feed creation date and time for feeds included in the response, in ISO 8601 format. The default is now.
+            key nextToken:string |  A string token returned in the response to your previous request. nextToken is returned when the number of results exceeds the specified pageSize value. To get the next page of results, call the getFeeds operation and include this token as the only parameter. Specifying nextToken with any other parameters will cause the request to fail.
+
+
+        Returns:
+            ApiResponse:
+        """
+
+        add_marketplace = should_add_marketplace(kwargs, "nextToken")
+        return await self._request(
+            kwargs.pop("path"), params=kwargs, add_marketplace=add_marketplace
+        )
+
+    async def submit_feed(
+        self, feed_type, file, content_type="text/tsv", **kwargs
+    ) -> [ApiResponse, ApiResponse]:
+        """
+        submit_feed(self, feed_type: str, file: File or File like, content_type='text/tsv', **kwargs) -> [ApiResponse, ApiResponse]
+        Combines `create_feed_document` and `create_feed`, uploads the file and sends the feed to amazon.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.0083                                  15
+        ======================================  ==============
+
+        Examples:
+            literal blocks::
+
+                feed = BytesIO
+                feed.write(<your feed>)
+                feed.seek(0)
+                Feeds().submit_feed('POST_FBA_INBOUND_CARTON_CONTENTS', feed, 'text/xml')
+
+
+        Args:
+            feed_type:
+            file:
+            content_type:
+            **kwargs:
+
+        Returns:
+            [ApiResponse:, ApiResponse:]
+        """
+        document_response = await self.create_feed_document(file, content_type)
+        return document_response, await self.create_feed(
+            feed_type, document_response.payload.get("feedDocumentId"), **kwargs
+        )
+
+    @sp_endpoint("/feeds/2021-06-30/feeds", method="POST")
+    async def create_feed(self, feed_type, input_feed_document_id, **kwargs) -> ApiResponse:
+        """
+        create_feed(self, feed_type: str, input_feed_document_id: str, **kwargs) -> ApiResponse
+
+        Creates a feed. Call `create_feed_document` to upload the feed first.
+        `submit_feed` combines both.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.0083                                  15
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Examples:
+            literal blocks::
+
+                Feeds().create_feed('POST_PRODUCT_DATA', '3d4e42b5-1d6e-44e8-a89c-2abfca0625bb',
+                              marketplaceIds=["ATVPDKIKX0DER", "A1F83G8C2ARO7P"])
+
+        Args:
+            feed_type: https://github.com/amzn/selling-partner-api-docs/blob/main/references/feeds-api/feedtype-values.md
+            input_feed_document_id: str
+            **kwargs:
+
+        Returns:
+            ApiResponse:
+        """
+        data = {
+            "feedType": feed_type,
+            "inputFeedDocumentId": input_feed_document_id,
+            **kwargs,
+        }
+        return await self._request(kwargs.pop("path"), data=data)
+
+    @sp_endpoint("/feeds/2021-06-30/feeds/{}", method="DELETE")
+    async def cancel_feed(self, feedId, **kwargs) -> ApiResponse:
+        """
+        cancel_feed(self, feedId, **kwargs) -> ApiResponse
+
+        Cancels the feed that you specify. Only feeds with processingStatus=IN_QUEUE can be cancelled. Cancelled feeds are returned in subsequent calls to the getFeed and getFeeds operations.
+
+        Args:
+
+            feedId:string | * REQUIRED The identifier for the feed. This identifier is unique only in combination with a seller ID.
+
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(fill_query_params(kwargs.pop("path"), feedId), data=kwargs)
+
+    @sp_endpoint("/feeds/2021-06-30/feeds/{}", method="GET")
+    async def get_feed(self, feedId, **kwargs) -> ApiResponse:
+        """
+        get_feed(self, feedId, **kwargs) -> ApiResponse
+
+        Returns feed details (including the resultDocumentId, if available) for the feed that you specify.
+
+        Args:
+
+            feedId:string | * REQUIRED The identifier for the feed. This identifier is unique only in combination with a seller ID.
+
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), feedId),
+            params=kwargs,
+            add_marketplace=False,
+        )
+
+    @sp_endpoint("/feeds/2021-06-30/documents", method="POST")
+    async def create_feed_document(self, file, content_type, **kwargs) -> ApiResponse:
+        """
+        create_feed_document(self, **kwargs) -> ApiResponse
+
+        Creates a feed document for the feed type that you specify. This operation returns a presigned URL for uploading the feed document contents. It also returns a feedDocumentId value that you can pass in with a subsequent call to the createFeed operation.
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            file: File or File like object. Setting this to None will skip the upload.
+            content_type: str
+            body: | * REQUIRED {'description': 'Specifies the content type for the createFeedDocument operation.', 'properties': {'contentType': {'description': 'The content type of the feed.', 'type': 'string'}}, 'required': ['contentType'], 'type': 'object'}
+
+
+        Returns:
+            ApiResponse:
+        """
+        data = {"contentType": kwargs.get("contentType", content_type)}
+        response = await self._request(kwargs.get("path"), data={**data, **kwargs})
+
+        if file is None:
+            return response
+
+        upload_data = file.read()
+        try:
+            upload_data = upload_data.encode("iso-8859-1")
+        except AttributeError:
+            pass
+        upload = await self._transport.request(
+            "PUT",
+            response.payload.get("url"),
+            content=upload_data,
+            headers={"Content-Type": content_type},
+        )
+        if 200 <= upload.status_code < 300:
+            return response
+        from sp_api.base.exceptions import SellingApiException
+
+        raise SellingApiException(
+            headers=upload.headers, error=upload.json().get("errors")
+        )
+
+    @sp_endpoint("/feeds/2021-06-30/documents/{}", method="GET")
+    async def get_feed_document(self, feedDocumentId, **kwargs) -> str:
+        """
+        get_feed_document(self, feedDocumentId, **kwargs) -> ApiResponse
+
+        Returns the information required for retrieving a feed document's contents.
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+
+            feedDocumentId:string | * REQUIRED The identifier of the feed document.
+
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self.get_feed_result_document(feedDocumentId)
+
+    @sp_endpoint("/feeds/2021-06-30/documents/{}", method="GET")
+    async def get_feed_result_document(self, feedDocumentId, **kwargs) -> str:
+        """
+        get_feed_result_document(self, feedDocumentId, **kwargs) -> str
+
+        Returns the feed result document's contents. First fetches from `getFeedDocument` endpont and then fetchs from the URL returned from it.
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            feedDocumentId: str
+            **kwargs:
+
+        Returns:
+            str:
+        """
+        response = await self._request(
+            fill_query_params(kwargs.pop("path"), feedDocumentId),
+            params=kwargs,
+            add_marketplace=False,
+        )
+        url = response.payload.get("url")
+        doc_response = await self._transport.request("GET", url)
+
+        encoding = (
+            doc_response.encoding
+            if doc_response and doc_response.encoding
+            else "iso-8859-1"
+        )
+        if encoding.lower() == "windows-31j":
+            encoding = "cp932"
+
+        content = doc_response.content
+        if "compressionAlgorithm" in response.payload:
+            try:
+                return zlib.decompress(bytearray(content), 15 + 32).decode(encoding)
+            except Exception:
+                return content.decode(encoding)
+        return content.decode(encoding)

sp_api/asyncio/api/finances/finances.py

@@ -0,0 +1,100 @@
+import enum
+
+from sp_api.base import Client, Marketplaces, ApiResponse
+from sp_api.asyncio.base import AsyncBaseClient
+from sp_api.base import sp_endpoint, fill_query_params
+
+class FinancesVersion(str, enum.Enum):
+    V_0 = "v0"
+    V_2024_06_19 = "2024-06-19"
+    LATEST = "2024-06-19"
+
+
+class Finances(AsyncBaseClient):
+    version: FinancesVersion = FinancesVersion.V_0
+
+    def __init__(self, *args, **kwargs):
+        if "version" in kwargs:
+            self.version = kwargs.get("version", FinancesVersion.V_0)
+        super().__init__(*args, **{**kwargs, "version": self.version})
+
+    @sp_endpoint("/finances/<version>/orders/{}/financialEvents")
+    async def get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse:
+        """
+        get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse
+
+        Examples:
+            literal blocks::
+
+                Finances().get_financial_events_for_order('485-734-5434857', MaxResultsPerPage=10)
+
+        Args:
+            order_id:
+            **kwargs:
+
+        Returns:
+
+        """
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), order_id), params={**kwargs}
+        )
+
+    @sp_endpoint("/finances/<version>/financialEvents")
+    async def list_financial_events(self, **kwargs) -> ApiResponse:
+        """
+        list_financial_events(self, **kwargs) -> ApiResponse:
+
+
+        Args:
+            **kwargs:
+
+        Returns:
+
+        """
+        return await self._request(fill_query_params(kwargs.pop("path")), params={**kwargs})
+
+    @sp_endpoint("/finances/<version>/financialEventGroups/{}/financialEvents")
+    async def list_financial_events_by_group_id(
+        self, event_group_id, **kwargs
+    ) -> ApiResponse:
+        """
+        list_financial_events_by_groupid(self, event_group_id,  **kwargs) -> ApiResponse:
+
+
+        Args:
+            event_group_id
+            **kwargs:
+
+        Returns:
+
+        """
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), event_group_id), params={**kwargs}
+        )
+
+    @sp_endpoint("/finances/<version>/financialEventGroups")
+    async def list_financial_event_groups(self, **kwargs) -> ApiResponse:
+        """
+        list_financial_event_groups(self, **kwargs) -> ApiResponse:
+
+
+        Args:
+            **kwargs:
+
+        Returns:
+
+        """
+        return await self._request(kwargs.pop("path"), params={**kwargs})
+
+    @sp_endpoint("/finances/<version>/transactions")
+    async def list_transactions(self, **kwargs) -> ApiResponse:
+        """
+        list_transactions(self, **kwargs) -> ApiResponse:
+
+        Args:
+            **kwargs:
+
+        Returns: ApiResponse
+        """
+
+        return await self._request(kwargs.pop("path"), params={**kwargs})