Get Quality Rating

Use this API to check the Quality Rating and Messaging Limits of your Gupshup app

You can use this API to check the Quality Rating, and Messaging Limits of your App. For an App, API requests are limited to once every 24 hours. To know more about Messaging Limits, click here. To learn about how you can determine the Quality Rating of your WABA i.e. Green, Yellow and Red, click here.


Authorization{{PARTNER_APP_TOKEN}}Access Token for the application
APP ID{{APP_ID}}Unique Identifier for Gupshup App

Sample Request

curl --location --request GET '{{APP_ID}}/ratings' \
--header 'Authorization: {{PARTNER_APP_TOKEN}}'

Sample Response

    "oldLimit": "TIER_10K",
    "currentLimit": "TIER_10K",
    "event": "ONBOARDING",
    "eventTime": 123455556,
    "phoneQuality": "GREEN"


    "message": "no event update available",  
    "status": "success"  

Response Codes

Status CodeResponseComments
200{ "oldLimit": "TIER_10K", "currentLimit": "TIER_10K", "event": "ONBOARDING", "eventTime": 123455556, "phoneQuality": "GREEN" }If we have received an event for the WABA
200{ "message": "no event update available", "status": "success" }If the API request is successful, but we have not received an event for the WABA's capacity and message limit.
429{ "status": "error", "message": "Too Many Requests" }10 Requests per Minute
500{ "status": "error", "message": "Internal server error. Please try again later and If Issue still persist than contact Gupshup Dev Support" }For any Internal Error
Click Try It! to start a request and see the response here!