kard-financial-sdk 0.0.82__py3-none-any.whl

kard/transactions/raw_client.py

@@ -0,0 +1,925 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ..commons.errors.conflict_error import ConflictError
+from ..commons.errors.does_not_exist_error import DoesNotExistError
+from ..commons.errors.internal_server_error import InternalServerError
+from ..commons.errors.invalid_request import InvalidRequest
+from ..commons.errors.unauthorized_error import UnauthorizedError
+from ..commons.types.error_response import ErrorResponse
+from ..commons.types.organization_id import OrganizationId
+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 jsonable_encoder
+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.create_audit_multi_status import CreateAuditMultiStatus
+from .errors.create_incoming_transactions_multi_status import CreateIncomingTransactionsMultiStatus
+from .errors.fraud_multi_status import FraudMultiStatus
+from .types.create_audit_multi_status_response import CreateAuditMultiStatusResponse
+from .types.create_audit_request_data_union import CreateAuditRequestDataUnion
+from .types.create_audit_response_body import CreateAuditResponseBody
+from .types.fraudulent_transaction_data import FraudulentTransactionData
+from .types.fraudulent_transaction_object import FraudulentTransactionObject
+from .types.fraudulent_transaction_response import FraudulentTransactionResponse
+from .types.get_earned_rewards_response import GetEarnedRewardsResponse
+from .types.transactions import Transactions
+from .types.transactions_multi_response import TransactionsMultiResponse
+from .types.transactions_response import TransactionsResponse
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawTransactionsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def create(
+        self,
+        organization_id: OrganizationId,
+        *,
+        data: typing.Sequence[Transactions],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[TransactionsResponse]:
+        """
+        Call this endpoint to send all transactions made by all your enrolled users in your rewards program. The request body will depend on the transaction type.<br/>
+        Please use the correct type when calling the endpoint:
+        - `transaction`: These incoming transactions will be processed and matched by the Kard system. Learn more about the [Transaction CLO Matching](https://github.com/kard-financial/kard-postman#c-transaction-clo-matching) flow here.
+        - `matchedTransaction`: For pre-matched transactions that need validation on match by the Kard system.<br/>
+
+        <b>Required scopes:</b> `transaction:write`<br/>
+        <b>Note:</b> `Maximum of 500 transactions can be created per request`.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        data : typing.Sequence[Transactions]
+            Discriminated union representing the request body for submitting a transaction.
+            Use `type` to distinguish between the two:
+            - `transaction`: For transactions requiring processing and matching by the Kard system.
+            - `matchedTransaction`: For pre-matched transactions that need validation on match by the Kard system.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[TransactionsResponse]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/transactions",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[Transactions], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TransactionsResponse,
+                    parse_obj_as(
+                        type_=TransactionsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 207:
+                raise CreateIncomingTransactionsMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        TransactionsMultiResponse,
+                        parse_obj_as(
+                            type_=TransactionsMultiResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create_fraud_markers(
+        self,
+        organization_id: OrganizationId,
+        *,
+        data: typing.Sequence[FraudulentTransactionData],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[FraudulentTransactionObject]:
+        """
+        Call this endpoint to flag a submitted transaction as fraudulent. This will prevent it from being rewarded.<br/>
+
+        <b>Required scopes:</b>&nbsp;&nbsp;`transaction:write`<br/>
+        <b>Note:</b> `Maximum of 500 fraudulent transactions can be created per request`.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        data : typing.Sequence[FraudulentTransactionData]
+            List of fraudulent transactions to report
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[FraudulentTransactionObject]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/fraud",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[FraudulentTransactionData], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    FraudulentTransactionObject,
+                    parse_obj_as(
+                        type_=FraudulentTransactionObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 207:
+                raise FraudMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        FraudulentTransactionResponse,
+                        parse_obj_as(
+                            type_=FraudulentTransactionResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create_audits(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        *,
+        data: typing.Sequence[CreateAuditRequestDataUnion],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[CreateAuditResponseBody]:
+        """
+        Call this endpoint to request that a particular transaction be audited further by the Kard system, in the event of a missing cashback claim, incorrect cashback amount claim or other mis-match claims.<br/>
+        <b>Required scopes:</b> `audit:write`
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        data : typing.Sequence[CreateAuditRequestDataUnion]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[CreateAuditResponseBody]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/audits",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[CreateAuditRequestDataUnion], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateAuditResponseBody,
+                    parse_obj_as(
+                        type_=CreateAuditResponseBody,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 207:
+                raise CreateAuditMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        CreateAuditMultiStatusResponse,
+                        parse_obj_as(
+                            type_=CreateAuditMultiStatusResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise DoesNotExistError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def get_earned_rewards(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        *,
+        page_after: typing.Optional[str] = None,
+        page_before: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[GetEarnedRewardsResponse]:
+        """
+        Retrieve rewarded transaction history for a specific user. Returns only SETTLED transactions within the last 12 months.
+        <br/>
+        <b>Required scopes:</b> `transaction:read`
+        <br/>
+        <b>Query Limit:</b> Maximum of 12 months of transaction data can be queried.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        page_after : typing.Optional[str]
+            Cursor for next page (base64-encoded timestamp + transaction ID)
+
+        page_before : typing.Optional[str]
+            Cursor for previous page (base64-encoded timestamp + transaction ID)
+
+        page_size : typing.Optional[int]
+            Number of results per page
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[GetEarnedRewardsResponse]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/earned-rewards",
+            method="GET",
+            params={
+                "page[after]": page_after,
+                "page[before]": page_before,
+                "page[size]": page_size,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetEarnedRewardsResponse,
+                    parse_obj_as(
+                        type_=GetEarnedRewardsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise DoesNotExistError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawTransactionsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def create(
+        self,
+        organization_id: OrganizationId,
+        *,
+        data: typing.Sequence[Transactions],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[TransactionsResponse]:
+        """
+        Call this endpoint to send all transactions made by all your enrolled users in your rewards program. The request body will depend on the transaction type.<br/>
+        Please use the correct type when calling the endpoint:
+        - `transaction`: These incoming transactions will be processed and matched by the Kard system. Learn more about the [Transaction CLO Matching](https://github.com/kard-financial/kard-postman#c-transaction-clo-matching) flow here.
+        - `matchedTransaction`: For pre-matched transactions that need validation on match by the Kard system.<br/>
+
+        <b>Required scopes:</b> `transaction:write`<br/>
+        <b>Note:</b> `Maximum of 500 transactions can be created per request`.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        data : typing.Sequence[Transactions]
+            Discriminated union representing the request body for submitting a transaction.
+            Use `type` to distinguish between the two:
+            - `transaction`: For transactions requiring processing and matching by the Kard system.
+            - `matchedTransaction`: For pre-matched transactions that need validation on match by the Kard system.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[TransactionsResponse]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/transactions",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[Transactions], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TransactionsResponse,
+                    parse_obj_as(
+                        type_=TransactionsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 207:
+                raise CreateIncomingTransactionsMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        TransactionsMultiResponse,
+                        parse_obj_as(
+                            type_=TransactionsMultiResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create_fraud_markers(
+        self,
+        organization_id: OrganizationId,
+        *,
+        data: typing.Sequence[FraudulentTransactionData],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[FraudulentTransactionObject]:
+        """
+        Call this endpoint to flag a submitted transaction as fraudulent. This will prevent it from being rewarded.<br/>
+
+        <b>Required scopes:</b>&nbsp;&nbsp;`transaction:write`<br/>
+        <b>Note:</b> `Maximum of 500 fraudulent transactions can be created per request`.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        data : typing.Sequence[FraudulentTransactionData]
+            List of fraudulent transactions to report
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[FraudulentTransactionObject]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/fraud",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[FraudulentTransactionData], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    FraudulentTransactionObject,
+                    parse_obj_as(
+                        type_=FraudulentTransactionObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 207:
+                raise FraudMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        FraudulentTransactionResponse,
+                        parse_obj_as(
+                            type_=FraudulentTransactionResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create_audits(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        *,
+        data: typing.Sequence[CreateAuditRequestDataUnion],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[CreateAuditResponseBody]:
+        """
+        Call this endpoint to request that a particular transaction be audited further by the Kard system, in the event of a missing cashback claim, incorrect cashback amount claim or other mis-match claims.<br/>
+        <b>Required scopes:</b> `audit:write`
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        data : typing.Sequence[CreateAuditRequestDataUnion]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[CreateAuditResponseBody]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/audits",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[CreateAuditRequestDataUnion], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateAuditResponseBody,
+                    parse_obj_as(
+                        type_=CreateAuditResponseBody,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 207:
+                raise CreateAuditMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        CreateAuditMultiStatusResponse,
+                        parse_obj_as(
+                            type_=CreateAuditMultiStatusResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise DoesNotExistError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def get_earned_rewards(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        *,
+        page_after: typing.Optional[str] = None,
+        page_before: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[GetEarnedRewardsResponse]:
+        """
+        Retrieve rewarded transaction history for a specific user. Returns only SETTLED transactions within the last 12 months.
+        <br/>
+        <b>Required scopes:</b> `transaction:read`
+        <br/>
+        <b>Query Limit:</b> Maximum of 12 months of transaction data can be queried.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        page_after : typing.Optional[str]
+            Cursor for next page (base64-encoded timestamp + transaction ID)
+
+        page_before : typing.Optional[str]
+            Cursor for previous page (base64-encoded timestamp + transaction ID)
+
+        page_size : typing.Optional[int]
+            Number of results per page
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[GetEarnedRewardsResponse]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/earned-rewards",
+            method="GET",
+            params={
+                "page[after]": page_after,
+                "page[before]": page_before,
+                "page[size]": page_size,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetEarnedRewardsResponse,
+                    parse_obj_as(
+                        type_=GetEarnedRewardsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise DoesNotExistError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # 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)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)