---
title: "List Packs"
method: GET
path: "/packs"
tags: ["Packs"]
---

# List Packs

`GET /packs`

Get the list of accessible Packs.

## Query parameters

- `accessType` 'none' | 'view' | 'test' | 'edit' | 'admin'
- `accessTypes` PackAccessType[]
- `sortBy` 'title' | 'createdAt' | 'updatedAt' — Determines how the Packs returned are sorted.
- `limit` integer
- `direction` 'ascending' | 'descending' — Direction of a sort for a table or view.
- `pageToken` string
- `onlyWorkspaceId` string
- `parentWorkspaceIds` string[]
- `excludePublicPacks` boolean
- `packEntrypoint` 'go' | 'docs'
- `excludePackCategories` PackCategoryType[]

## Response `200`

List of Pack summaries.

- PackSummaryList — List of Pack summaries.
  - `items` PackSummary[], required
    - `id` number, required — ID of the Pack.
    - `logoUrl` string, url — The link to the logo of the Pack.
    - `coverUrl` string, url — The link to the cover photo of the Pack.
    - `exampleImages` PackImageFile[] — The example images for the Pack.
      - `filename` string, required — The name of the image file.
      - `imageUrl` string, url, required — The URL to the image file.
      - `assetId` string, required — The asset id of the Pack's image.
      - `altText` string — The alt text for the image.
      - `mimeType` string — The media type of the image.
    - `agentImages` PackImageFile[] — The agent images for the Pack.
      - `filename` string, required — The name of the image file.
      - `imageUrl` string, url, required — The URL to the image file.
      - `assetId` string, required — The asset id of the Pack's image.
      - `altText` string — The alt text for the image.
      - `mimeType` string — The media type of the image.
    - `workspaceId` string, required — The parent workspace for the Pack.
    - `categories` PublishingCategory[], required — Publishing categories associated with this Pack.
      - `categoryId` string, required — The ID for this category.
      - `categoryName` string, required — The name of the category.
      - `categorySlug` string — The URL identifier of the category.
    - `certified` boolean — Denotes if the Pack is certified by Superhuman.
    - `certifiedAgent` boolean — Denotes if the Pack is certified by Grammarly to be optimized for agent usage.
    - `sourceCodeVisibility` 'private' | 'shared' — Visibility of a Pack's source code.
    - `packEntrypoints` PackEntrypoint[] — Pack entrypoints where this Pack is available
    - `verifiedVersion` string — The latest released Pack version that has been verified (approved) for use. For agent Packs, this is the most recent release that passed review. For non-agent Packs or legacy releases, this is the most recent release.
    - `name` string, required — The name of the Pack.
    - `description` string, required — The full description of the Pack.
    - `shortDescription` string, required — A short version of the description of the Pack.
    - `agentShortDescription` string — A short description for the Pack as an agent.
    - `agentDescription` string — A full description for the Pack as an agent.
    - `supportEmail` string — A contact email for the Pack.
    - `termsOfServiceUrl` string, url — A Terms of Service URL for the Pack.
    - `privacyPolicyUrl` string, url — A Privacy Policy URL for the Pack.
  - `nextPageToken` string — If specified, an opaque token used to fetch the next page of results.
  - `nextPageLink` string, url — If specified, a link that can be used to fetch the next page of results.

## Other responses

- `400` — The request parameters did not conform to expectations.
- `401` — The API token is invalid or has expired.
- `429` — The client has sent too many requests.

---

[API](https://skmtc.net/coda/apis/superhuman-docs-api.md) · [All operations](https://skmtc.net/coda/apis/superhuman-docs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coda/superhuman-docs-api/revisions/c65a8418f3c8/schema)