---
title: "Public Collections"
method: GET
path: "/collections"
tags: ["collections"]
---

# Public Collections

`GET /collections`

Returns a list of public collections

## Query parameters

- `page` integer
- `page_size` integer
- `limit` integer
- `offset` integer
- `order` 'published_date' | 'created_date' | 'modified_date' | 'views' | 'shares' | 'cites'
- `order_direction` 'asc' | 'desc'
- `institution` integer
- `published_since` string
- `modified_since` string
- `group` integer
- `resource_doi` string
- `doi` string
- `handle` string

## Headers

- `X-Cursor` string

## Response `200`

OK. An array of collections

- Collection[]
  - `id` integer, required — Collection id
  - `title` string, required — Collection title
  - `doi` string, required — Collection DOI
  - `handle` string, required — Collection Handle
  - `url` string, required — Api endpoint
  - `timeline` Timeline, required — Legacy timeline input (used by /v2/account/articles). Items with item-type based metadata do not use this object — pass dates as stock fields inside fields: {} instead.
    - `firstOnline` string — Online posted date
    - `publisherPublication` string — Publish date
    - `publisherAcceptance` string — Date when the item was accepted for publication
  - `published_date` string — Date when collection was first published, null if not published

## Other responses

- `400` — Bad Request
- `422` — Bad Request
- `500` — Internal Server Error

---

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