---
source_url: https://www.pubnub.com/docs/admin-api/list-deployments-for-a-revision
title: List deployments for a revision
---

# List deployments for a revision

> For AI agents: documentation index at https://www.pubnub.com/llms-full.txt

Returns a paginated list of package deployments for a given revision. **Permissions:** `functions.package-deployment:read` on `keyset`

## Request

Example

```
{
  "data": [
    {
      "id": "d4e5f6a7-b8c9-0123-def0-123456789abc",
      "packageRevisionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "keysetId": 12345,
      "state": "STOPPED",
      "functionDeployments": [
        {}
      ],
      "createdDttm": "2026-01-15T10:30:00.000Z",
      "updatedDttm": "2026-02-01T14:20:00.000Z"
    }
  ],
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "paging": {
      "totalElements": 0,
      "totalPages": 0,
      "pageSize": 0,
      "pageNumber": 0,
      "pageOffset": 0
    }
  },
  "errors": []
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```