---
source_url: https://www.pubnub.com/docs/admin-api/get-a-package-deployment
title: Get a package deployment
---

# Get a package deployment

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

Returns a single package deployment by ID. **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": [
      {
        "functionRevisionId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "state": "RUNNING",
        "createdDttm": "2026-01-15T10:30:00.000Z",
        "updatedDttm": "2026-02-01T14:20:00.000Z"
      }
    ],
    "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"
  },
  "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"
    }
  ]
}
```