# com.emdashcms.experimental.aggregator.getPackage

> Published by [emdashcms.com](https://lexicon.garden/identity/did:plc:ilznslhspsvk6naatedr66pi)

✓ This is the authoritative definition for this NSID.

## Description

Get a single package by its canonical (did, slug) identity. EXPERIMENTAL.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:ilznslhspsvk6naatedr66pi/com.emdashcms.experimental.aggregator.getPackage)
- [Documentation](https://lexicon.garden/lexicon/did:plc:ilznslhspsvk6naatedr66pi/com.emdashcms.experimental.aggregator.getPackage/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:ilznslhspsvk6naatedr66pi/com.emdashcms.experimental.aggregator.getPackage/examples)

## Definitions

### `com.emdashcms.experimental.aggregator.getPackage`

**Type**: `query`

Returns the aggregator's view of one package, including the signed profile record, denormalised metadata for display, and any hydrated labels. Returns NotFound if the aggregator has no record of this (did, slug) pair, or if the package has been tombstoned.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `did` | `string` (did) | Yes | Publisher DID. |
| `slug` | `string` | Yes | Package slug. |

#### Output

**Encoding**: `application/json`

#### Errors

- **NotFound**: No package indexed under the given (did, slug). Aggregators that hard-delete on publisher deletion (rather than soft-deleting) return NotFound for both the never-indexed and the deleted cases — clients should treat them equivalently.
- **ListingUnavailable**: The package is indexed but has no profile revision available under the aggregator's listing policy. No publisher-controlled content is returned.

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Returns the aggregator's view of one package, including the signed profile record, denormalised metadata for display, and any hydrated labels. Returns NotFound if the aggregator has no record of this (did, slug) pair, or if the package has been tombstoned.",
      "errors": [
        {
          "description": "No package indexed under the given (did, slug). Aggregators that hard-delete on publisher deletion (rather than soft-deleting) return NotFound for both the never-indexed and the deleted cases — clients should treat them equivalently.",
          "name": "NotFound"
        },
        {
          "description": "The package is indexed but has no profile revision available under the aggregator's listing policy. No publisher-controlled content is returned.",
          "name": "ListingUnavailable"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "ref": "com.emdashcms.experimental.aggregator.defs#packageView",
          "type": "ref"
        }
      },
      "parameters": {
        "properties": {
          "did": {
            "description": "Publisher DID.",
            "format": "did",
            "type": "string"
          },
          "slug": {
            "description": "Package slug.",
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "did",
          "slug"
        ],
        "type": "params"
      },
      "type": "query"
    }
  },
  "description": "Get a single package by its canonical (did, slug) identity. EXPERIMENTAL.",
  "id": "com.emdashcms.experimental.aggregator.getPackage",
  "lexicon": 1
}
```