> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Proxy Group Deploy History

> Returns the deploy/undeploy history list of the specified API Proxy Group. Each record includes the revision number, deployment timestamp, user, environment, description, and persistent flag.

## Endpoint

```
GET /apiops/projects/{projectName}/apiProxyGroups/{apiProxyGroupName}/deploy-histories/
```

## Authentication

Requires a Personal API Access Token.

### Header

```
Authorization: Bearer YOUR_TOKEN
```

## Request

### Headers

| Header        | Value          | Required |
| ------------- | -------------- | -------- |
| Authorization | Bearer {token} | Yes      |

### Path Parameters

| Parameter         | Type   | Required | Description                       |
| ----------------- | ------ | -------- | --------------------------------- |
| projectName       | string | Yes      | Project name                      |
| apiProxyGroupName | string | Yes      | API Proxy Group name (must exist) |

### Query Parameters

None

### Request Body

This endpoint does not require a request body.

## Response

### Success Response (200 OK)

```json theme={null}
{
  "status": "SUCCESS",
  "resultList": [
    {
      "revision": 8,
      "username": "admin",
      "date": "2026-04-16T10:30:00Z",
      "description": "v2.1 group release",
      "environment": "production",
      "deploy": true,
      "persistent": false
    },
    {
      "revision": 7,
      "username": "admin",
      "date": "2026-04-15T08:00:00Z",
      "description": "Undeployed for maintenance",
      "environment": "production",
      "deploy": false,
      "persistent": true
    }
  ],
  "resultCount": 2
}
```

#### Response Fields

| Field                     | Type    | Description                                                     |
| ------------------------- | ------- | --------------------------------------------------------------- |
| status                    | string  | Request status (`SUCCESS` or `FAILURE`)                         |
| resultList                | array   | List of deploy history records                                  |
| resultList\[].revision    | integer | Sequentially incrementing revision number (per API Proxy Group) |
| resultList\[].username    | string  | User who performed the deployment                               |
| resultList\[].date        | string  | ISO 8601 deployment timestamp                                   |
| resultList\[].description | string  | Deployment description/notes                                    |
| resultList\[].environment | string  | Target environment name                                         |
| resultList\[].deploy      | boolean | `true` for deploy, `false` for undeploy                         |
| resultList\[].persistent  | boolean | Whether this record is protected from auto-deletion             |
| resultCount               | integer | Total number of records                                         |

### Error Response (400 Bad Request)

```json theme={null}
{
  "error": "bad_request",
  "error_description": "API Proxy Group (PaymentAPIGroup) is not found or user does not have privilege to access it!"
}
```

### Error Response (401 Unauthorized)

```json theme={null}
{
  "error": "unauthorized_client",
  "error_description": "Invalid token"
}
```

## cURL Example

```bash theme={null}
curl -X GET \
  "https://demo.apinizer.com/apiops/projects/MyProject/apiProxyGroups/PaymentAPIGroup/deploy-histories/" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Notes and Warnings

* **Revision Number**: Each deploy/undeploy operation receives a sequentially incrementing `revision` per API Proxy Group. Use this value in detail and delete endpoints.
* **Persistent Records**: Records marked as `persistent: true` are never auto-deleted, even when the system-wide deploy history retention limit is exceeded.

## Permissions

User must have **`API_MANAGEMENT` + `VIEW`** permission in the project.

## Related Documentation

* [Deploy API Proxy Group](/api-reference/api-proxy-groups/deployment/deploy-api-proxy-group) - Deploy group to environment
* [Get Deploy History Detail](/api-reference/api-proxy-groups/deployment/get-deploy-history-detail) - Get full detail of a deploy history record
* [Delete Deploy History](/api-reference/api-proxy-groups/deployment/delete-deploy-history) - Delete a deploy history record