Get app details based on appId

Use this API to fetch the app details based on appId.

🚧

callbackURL and billingType in response
will be deprecated from 19th Feb 2025

Parameters

KeyDescriptionConstraintsRequired/OptionalTypeValue
PARTNER_TOKENJWT Token issues post Partner loginShould be a valid Partner JWT Token.String
appIdid of the app for which data is to be fetched- The id should be a valid app Id of gupshup - App should be in the account whose PARTNER_TOKEN is being usedString

Sample Request

curl --location --request GET '{{partner_portal_base_url}}/partner/app/:appId/details' \
--header 'token: {{PARTNER_TOKEN}}'

Sample Response

{ 
	"status": "success",
 	"appDetails": {
 		"billingType": "<POSTPAID,PREPAID>",////will be deprecated since 19th Feb 2025
 		"createdOn": <timestamp>,
        "callbackUrl": "<callback_url>", //will be deprecated since 19th Feb 2025
 		"disableOptinPrefUrl": <true/false>,
 		"embedAllowed": <true/false>,
 		"federated": <true/false>,
 		"id": "<app_id>",
 		"languageCode": "<language_code>", 
		"live": <true/false>,
 		"liveTs": <timestamp>,
 		"modifiedOn": <timestamp>,
 		"name": "<app_name>",
        "phone": "phone",
 		"stopped": <true/false>,
 		"storageRegion": "<BR, DE, CH, GB, BH, ZA, AE, US, CA, AU, ID, IN, JP, SG, KR>", 
 		"templateMessaging": <true/false>, 
 		"type": "apicallbackpost",
 		"version": <0,1,2>
	},
 	"app": "true"
}

Status Codes

Status CodeResponseComment
Success
200{ "status": "success", "appDetails": { "billingType": "\<POSTPAID,PREPAID>", "createdOn": <timestamp>, "callbackUrl": "\<callback_url>", //if set "disableOptinPrefUrl": \<true/false>, "embedAllowed": \<true/false>, "federated": \<true/false>, "id": "\<app_id>", "languageCode": "\<language_code>", "live": \<true/false>, "liveTs": <timestamp>, "modifiedOn": <timestamp>, "name": "\<app_name>", "phone": "phone", "stopped": \<true/false>, "storageRegion": "\<BR, DE, CH, GB, BH, ZA, AE, US, CA, AU, ID, IN, JP, SG, KR>", "templateMessaging": \<true/false>, "type": "apicallbackpost", "version": \<0,1,2> }, "app": "true" }
Error
400{ "status":"error", "message/data":"<Specific to API>" }Either the request parameter type or HTTP request type is incorrect
401{ "status":"error", "message":"Unauthorized Access" }If the token is incorrect or forbidden.
403{ "status":"error", "message":"Unauthorized Access" }When app does not belong to the Partner
429{ "status": "error", "message": "Too Many Requests" }When the rate limit is exceeded
Language
Click Try It! to start a request and see the response here!