---
title: "Get collections"
method: GET
path: "/api/collections"
tags: ["collections"]
---

# Get collections

`GET /api/collections`

## Query parameters

- `item` union
  - string[]
  - string
- `owner` union
  - string[]
  - string
  - object
- `q` string
- `sort` 'upvotes' | 'lastModified' | 'trending'
- `cursor` string
- `expand` boolean
- `limit` number

## Response `200`

The collection data

- union
  - object[]
    - `slug` string, required
    - `title` string, required
    - `description` string
    - `lastUpdated` string, date-time, required
    - `gating` union, required
      - unknown
      - unknown
      - object
        - `mode` 'auto', required
      - object
        - `mode` 'manual', required
        - `notifications` object, required
          - `mode` 'bulk' | 'real-time', required
          - `email` string
    - `owner` union, required
      - object
        - `_id` string, required
        - `avatarUrl` string, required
        - `fullname` string, required
        - `name` string, required
        - `isHf` boolean, required
        - `isHfAdmin` boolean, required
        - `isMod` boolean, required
        - `followerCount` number
        - `type` 'org', required
        - `plan` 'team' | 'enterprise' | 'plus' | 'academia'
        - `isUserFollowing` boolean
      - object
        - `_id` string, required
        - `avatarUrl` string, required
        - `fullname` string, required
        - `name` string, required
        - `isHf` boolean, required
        - `isHfAdmin` boolean, required
        - `isMod` boolean, required
        - `followerCount` number
        - `type` 'user', required
        - `isPro` boolean, required
        - `isUserFollowing` boolean
        - `primaryOrg` object
          - `avatarUrl` string, required
          - `fullname` string, required
          - `name` string, required
          - `type` 'org', required
          - `isHf` boolean, required
          - `isFollowing` boolean
          - `plan` 'team' | 'enterprise' | 'plus' | 'academia'
          - `details` string
          - `hasPrivateMembersList` boolean
          - `userRole` union
            - 'admin' | 'write' | 'contributor' | 'read' | 'no_access'
            - string — Custom role name
          - `numUsers` number
    - `theme` 'orange' | 'blue' | 'green' | 'purple' | 'pink' | 'indigo', required
    - `private` boolean, required
    - `upvotes` number, required
    - `isUpvotedByUser` boolean, required
    - `resourceGroup` object
      - `id` string, required
      - `name` string, required
      - `numUsers` number
    - `items` union[], required
      - union
        - object
          - `_id` string, required
          - `note` object
            - `html` string, required
            - `text` string, required
          - `gallery` string[]
          - `position` number, required
          - `author` string, required
          - `id` string, required
          - `isLikedByUser` boolean, required
          - `likes` number, required
          - `datasetsServerInfo` object
            - `viewer` 'preview' | 'viewer-partial' | 'viewer', required
            - `numRows` number, nullable, required
            - `libraries` string[], required
            - `formats` string[], required
            - `modalities` string[], required
          - `private` boolean, required
          - `repoType` 'dataset', required
          - `downloads` number, required
          - `gated` union, required
            - unknown
            - 'auto' | 'manual'
          - `lastModified` string, date-time, required
          - `resourceGroup` object
            - `id` string, required
            - `name` string, required
            - `numUsers` number
          - `isBenchmark` boolean
          - `isTraces` boolean
          - `type` 'dataset', required
        - object
          - `_id` string, required
          - `note` object
            - `html` string, required
            - `text` string, required
          - `gallery` string[]
          - `position` number, required
          - `author` string, required
          - `downloads` number, required
          - `id` string, required
          - `availableInferenceProviders` object[], required
            - `provider` 'baseten' | 'cerebras' | 'cohere' | 'deepinfra' | 'fal-ai' | 'featherless-ai' | 'fireworks-ai' | 'groq' | 'hf-inference' | 'novita' | 'nscale' | 'openai' | 'ovhcloud' | 'publicai' | 'replicate' | 'scaleway' | 'together' | 'wavespeed' | 'zai-org', required
            - `providerStatus` 'live' | 'staging' | 'error', required
            - `modelStatus` 'live' | 'staging' | 'error', required
            - `providerId` string, required
            - `task` 'text-classification' | 'token-classification' | 'table-question-answering' | 'question-answering' | 'zero-shot-classification' | 'translation' | 'summarization' | 'feature-extraction' | 'text-generation' | 'fill-mask' | 'sentence-similarity' | 'text-to-speech' | 'text-to-audio' | 'automatic-speech-recognition' | 'audio-to-audio' | 'audio-classification' | 'audio-text-to-text' | 'voice-activity-detection' | 'depth-estimation' | 'image-classification' | 'object-detection' | 'image-segmentation' | 'text-to-image' | 'image-to-text' | 'image-to-image' | 'image-to-video' | 'unconditional-image-generation' | 'video-classification' | 'reinforcement-learning' | 'robotics' | 'tabular-classification' | 'tabular-regression' | 'tabular-to-text' | 'table-to-text' | 'multiple-choice' | 'text-ranking' | 'text-retrieval' | 'time-series-forecasting' | 'text-to-video' | 'image-text-to-text' | 'image-text-to-image' | 'image-text-to-video' | 'visual-question-answering' | 'document-question-answering' | 'zero-shot-image-classification' | 'graph-ml' | 'mask-generation' | 'zero-shot-object-detection' | 'text-to-3d' | 'image-to-3d' | 'image-feature-extraction' | 'video-text-to-text' | 'keypoint-detection' | 'visual-document-retrieval' | 'any-to-any' | 'video-to-video' | 'other' | 'conversational', required
            - `adapterType` 'lora'
            - `adapterWeightsPath` string
            - `features` object
              - …
            - `isCheapestPricingOutput` boolean, required
            - `isFastestThroughput` boolean, required
            - `isModelAuthor` boolean, required
            - `tokensPerSecond` number
            - `pricingOutput` number
            - `freeUntil` string, date-time
          - `isLikedByUser` boolean, required
          - `lastModified` string, date-time, required
          - `likes` number, required
          - `pipeline_tag` string
          - `private` boolean, required
          - `repoType` 'model', required
          - `gated` union, required
            - unknown
            - 'auto' | 'manual'
          - `resourceGroup` object
            - `id` string, required
            - `name` string, required
            - `numUsers` number
          - `numParameters` number
          - `authorData` union
            - object
              - …
            - object
              - …
          - `widgetOutputUrls` string[]
          - `isPreRelease` unknown
          - `type` 'model', required
        - object
          - `_id` string, required
          - `note` object
            - `html` string, required
            - `text` string, required
          - `gallery` string[]
          - `position` number, required
          - `author` string, required
          - `colorFrom` string, required
          - `colorTo` string, required
          - `createdAt` string, date-time, required
          - `emoji` string, required
          - `id` string, required
          - `isLikedByUser` boolean, required
          - `lastModified` string, date-time, required
          - `likes` number, required
          - `pinned` boolean, required
          - `private` boolean, required
          - `repoType` 'space', required
          - `title` string, required
          - `sdk` 'gradio' | 'docker' | 'static' | 'streamlit'
          - `runtime` object, required
            - `stage` 'NO_APP_FILE' | 'CONFIG_ERROR' | 'BUILDING' | 'BUILD_ERROR' | 'APP_STARTING' | 'RUNNING' | 'RUNNING_BUILDING' | 'RUNNING_APP_STARTING' | 'RUNTIME_ERROR' | 'DELETING' | 'STOPPED' | 'PAUSED' | 'SLEEPING', required
            - `hardware` object, required
              - …
            - `errorMessage` string
            - `gcTimeout` number, nullable
            - `replicas` object, required
              - …
            - `devMode` boolean
            - `domains` object[]
              - …
            - `sha` string
            - `hotReloading` object
              - …
          - `disabled` boolean, required
          - `originRepo` object
            - `author` union, required
              - …
            - `name` string, required
          - `ai_short_description` string
          - `ai_category` string
          - `trendingScore` number
          - `resourceGroup` object
            - `id` string, required
            - `name` string, required
            - `numUsers` number
          - `tags` string[], required
          - `authorData` union
            - object
              - …
            - object
              - …
          - `shortDescription` string
          - `semanticRelevancyScore` number
          - `featured` boolean, required
          - `visibility` 'public' | 'private' | 'protected', required
          - `type` 'space', required
        - object
          - `_id` string, required
          - `note` object
            - `html` string, required
            - `text` string, required
          - `gallery` string[]
          - `position` number, required
          - `id` string, required
          - `title` string, required
          - `upvotes` number, required
          - `publishedAt` string, date-time, required
          - `thumbnailUrl` string
          - `isUpvotedByUser` boolean
          - `type` 'paper', required
        - object
          - `_id` string, required
          - `note` object
            - `html` string, required
            - `text` string, required
          - `gallery` string[]
          - `position` number, required
          - `slug` string, required
          - `lastUpdated` string, date-time, required
          - `description` string
          - `owner` union, required
            - object
              - …
            - object
              - …
          - `title` string, required
          - `theme` 'orange' | 'blue' | 'green' | 'purple' | 'pink' | 'indigo', required
          - `upvotes` number, required
          - `isUpvotedByUser` boolean, required
          - `shareUrl` string, required
          - `id` string, required
          - `numberItems` number, required
          - `type` 'collection', required
        - object
          - `_id` string, required
          - `note` object
            - `html` string, required
            - `text` string, required
          - `gallery` string[]
          - `position` number, required
          - `author` string, required
          - `id` string, required
          - `private` boolean, nullable
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `size` number, required — The amount of storage used by the bucket in bytes
          - `totalFiles` number, required — The total number of files in the bucket
          - `repoType` 'bucket', required
          - `adminTags` string[]
          - `disabled` object
            - `reason` string, required
            - `hideReadme` boolean
          - `cdnRegions` object[], required
            - `provider` 'gcp' | 'aws', required
            - `region` 'us' | 'eu', required
          - `resourceGroup` object
            - `id` string, required
            - `name` string, required
            - `numUsers` number
          - `type` 'bucket', required
  - object[]
    - `title` string, required
    - `private` boolean, required
    - `upvotes` number, required
    - `resourceGroup` object
      - `id` string, required
      - `name` string, required
      - `numUsers` number
    - `name` string, required

---

[API](https://skmtc.net/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.net/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/versions/dae0cc3790f0/schema)