---
title: "Retrieve a collection by alias."
method: GET
path: "/organizations/collections/{alias}/aliases"
tags: ["organizations"]
---

# Retrieve a collection by alias.

`GET /organizations/collections/{alias}/aliases`

Retrieve a collection by alias.

## Path parameters

- `alias` string, required

## Response `default`

default response

- Collection — Collection in an organization, collects entries
  - `aliases` object
  - `dbCreateDate` integer
  - `dbUpdateDate` integer
  - `description` string — Description of the collection
  - `displayName` string
  - `entries` CollectionEntry[]
    - `categories` CategorySummary[]
      - `aiManaged` boolean
      - `curator` 'USER' | 'DOCKSTORE' | 'AI'
      - `description` string
      - `displayName` string
      - `id` integer
      - `metadata` object
      - `name` string
      - `topic` string
    - `curator` 'USER' | 'DOCKSTORE' | 'AI'
    - `dbUpdateDate` integer
    - `descriptorTypes` string[]
    - `entryPath` string
    - `entryType` string
    - `id` integer
    - `isApprovedAITopic` boolean
    - `labels` string[]
    - `topic` string
    - `topicSelection` 'AUTOMATIC' | 'MANUAL' | 'AI'
    - `verified` boolean
    - `versionName` string
  - `id` integer — Implementation specific ID for the collection in this web service
  - `metadata` object — Arbitrary metadata for this collection, settable only by admins and curators
  - `name` string, required — Name of the collection
  - `notebooksLength` integer — Number of notebooks inside this collection
  - `organizationID` integer
  - `organizationName` string
  - `servicesLength` integer — Number of services inside this collection
  - `toolsLength` integer — Number of tools inside this collection
  - `topic` string, required — Short description of the collection
  - `workflowsLength` integer — Number of workflows inside this collection

## Changes

- **2026-06-24** `00145cade28a` — 1 info
  - added the optional property `entries/items/categories/items/metadata` to the response with the `default` status
- **2026-06-04** `ed2eca881e4c` — 3 info
  - added the optional property `entries/items/categories/items/aiManaged` to the response with the `default` status
  - added the optional property `entries/items/categories/items/curator` to the response with the `default` status
  - added the optional property `entries/items/curator` to the response with the `default` status
- **2026-05-22** `5b6e0475c79a` — 2 breaking, 1 info
  - the `displayName` response property's maxLength was increased from `50` to `90` for the response status `default`
  - the `name` response property's maxLength was increased from `39` to `90` for the response status `default`
  - the `name` response's property pattern was changed from `[a-zA-Z](-?[a-zA-Z\d]){0,38}` to `[a-zA-Z](-?[a-zA-Z\d]){0,89}` for the status `default`
- **2026-05-14** `5ee1a2809632` — 1 info
  - added the optional property `metadata` to the response with the `default` status
- …earlier changes not shown

[Full history](https://skmtc.dev/dockstore/apis/dockstore-api/changes/organizations/collections/:alias/aliases/get.md)

---

[API](https://skmtc.dev/dockstore/apis/dockstore-api.md) · [All operations](https://skmtc.dev/dockstore/apis/dockstore-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dockstore/dockstore-api/revisions/9d82a4e96aa7/schema)