:doc:`PinpointSMSVoiceV2 <../../pinpoint-sms-voice-v2>` / Client / describe_spend_limits

*********************
describe_spend_limits
*********************



.. py:method:: PinpointSMSVoiceV2.Client.describe_spend_limits(**kwargs)

  

  Describes the current monthly spend limits for sending voice and text messages.

   

  When you establish an Amazon Web Services account, the account has initial monthly spend limit in a given Region. For more information on increasing your monthly spend limit, see `Requesting increases to your monthly SMS, MMS, or Voice spending quota <https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html>`__ in the *End User Messaging SMS User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeSpendLimits>`_  


  **Request Syntax**
  ::

    response = client.describe_spend_limits(
        NextToken='string',
        MaxResults=123
    )
    
  :type NextToken: string
  :param NextToken: 

    The token to be used for the next set of paginated results. You don't need to supply a value for this field in the initial request.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results to return per each request.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'SpendLimits': [
              {
                  'Name': 'TEXT_MESSAGE_MONTHLY_SPEND_LIMIT'|'VOICE_MESSAGE_MONTHLY_SPEND_LIMIT'|'MEDIA_MESSAGE_MONTHLY_SPEND_LIMIT',
                  'EnforcedLimit': 123,
                  'MaxLimit': 123,
                  'Overridden': True|False
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **SpendLimits** *(list) --* 

        An array of SpendLimit objects that contain the details for the requested spend limits.

        
        

        - *(dict) --* 

          Describes the current monthly spend limits for sending voice and text messages. For more information on increasing your monthly spend limit, see `Requesting a spending quota increase <https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html>`__ in the *End User Messaging SMS User Guide*.

          
          

          - **Name** *(string) --* 

            The name for the SpendLimit.

            
          

          - **EnforcedLimit** *(integer) --* 

            The maximum amount of money, in US dollars, that you want to be able to spend sending messages each month. This value has to be less than or equal to the amount in ``MaxLimit``. To use this custom limit, ``Overridden`` must be set to true.

            
          

          - **MaxLimit** *(integer) --* 

            The maximum amount of money that you are able to spend to send messages each month, in US dollars.

            
          

          - **Overridden** *(boolean) --* 

            When set to ``True``, the value that has been specified in the ``EnforcedLimit`` is used to determine the maximum amount in US dollars that can be spent to send messages each month, in US dollars.

            
      
    
      

      - **NextToken** *(string) --* 

        The token to be used for the next set of paginated results. If this field is empty then there are no more results.

        
  
  **Exceptions**
  
  *   :py:class:`PinpointSMSVoiceV2.Client.exceptions.ThrottlingException`

  
  *   :py:class:`PinpointSMSVoiceV2.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`PinpointSMSVoiceV2.Client.exceptions.ValidationException`

  
  *   :py:class:`PinpointSMSVoiceV2.Client.exceptions.InternalServerException`

  