---
updatedAt: 2026-10-01T07:12:42.000Z
agentTools:
  projectIndex: https://partner-docs.gupshup.io/llms.txt
---

# Get Partner Apps

Retrieves the list of partner applications linked to the authenticated partner account, including health status from DockerDetails and capping information from CappingDetails

### Parameters

| Parameters    | Value                | Description                          |
| :------------ | :------------------- | :----------------------------------- |
| Authorization | \{\{PARTNER\_TOKEN}} | JWT Token issued post Partner login. |

### Sample Request

```curl
curl --location --request GET 'https://partner.gupshup.io/partner/account/api/partnerApps' \
--header 'Authorization: {{PARTNER_TOKEN}}'
```

### Sample Response

```json
{
    "status": "success",
    "partnerAppsList": [
        {
            "id": "00065097-93ff-4c22-bfa4-845f01b7de3b",
            "name": "BotTch20",
            "customerId": "4000001311",
            "live": false,
            "partnerId": 6,
            "createdOn": 1624339843605,
            "modifiedOn": 1651130376253,
            "partnerCreated": false,
            "cxpEnabled": false,
            "partnerUsage": true, 
            "stopped": false,
            "healthy": true,
            "cap": 0.0
        },
        {
            "id": "018358b5-5ac1-44af-bbfe-36ac4e9f01cc",
            "name": "automation030542",
            "customerId": "NA",
            "live": false,
            "partnerId": 6,
            "createdOn": 1703857396150,
            "modifiedOn": 1703857396150,
            "partnerCreated": false,
            "cxpEnabled": false,
            "partnerUsage": true,
            "stopped": false,
            "healthy": true,
            "cap": 0.0
        },
        {
            "id": "02f9e530-f7dd-4a04-ad33-4406d29c9e56",
            "name": "TestAPI70",
            "customerId": "4000001585",
            "live": false,
            "partnerId": 6,
            "createdOn": 1651738868991,
            "modifiedOn": 1651738868991,
            "partnerCreated": false,
            "cxpEnabled": false,
            "partnerUsage": true, 
            "stopped": false,
            "healthy": true,
            "cap": 0.0
        },
        {
            "id": "04e6c66b-bb95-4bfc-b75e-4e7391ddc680",
            "name": "GupShupQAHSM",
            "phone": "919324927406",
            "customerId": "4000001343",
            "live": false,
            "partnerId": 6,
            "createdOn": 1690874640468,
            "modifiedOn": 1698409662019,
            "partnerCreated": false,
            "cxpEnabled": false,
            "partnerUsage": true, 
            "stopped": false,
            "healthy": true,
            "cap": 0.0
        },
        {
            "id": "0adef57e-b1fe-41eb-94e7-c47e29fbc50f",
            "name": "automation9525531",
            "customerId": "NA",
            "live": false,
            "partnerId": 6,
            "createdOn": 1703856050646,
            "modifiedOn": 1703856050646,
            "partnerCreated": false,
            "cxpEnabled": false,
            "partnerUsage": true, 
            "stopped": false,
            "healthy": true,
            "cap": 0.0
        }]
}
```

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Partner Portal Public APIs",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://partner.gupshup.io"
    }
  ],
  "tags": [
    {
      "name": "Partner"
    }
  ],
  "paths": {
    "/partner/account/api/partnerApps": {
      "get": {
        "tags": [
          "Partner"
        ],
        "summary": "Get Partner Apps",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "{{PARTNER_TOKEN}}"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {}
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {}
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {}
            }
          }
        },
        "description": "Retrieves the list of partner applications linked to the authenticated partner account, including health status from DockerDetails and capping information from CappingDetails"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```