---
title: "Public Collections Search"
method: POST
path: "/collections/search"
tags: ["collections"]
---

# Public Collections Search

`POST /collections/search`

Returns a list of public collections

## Headers

- `X-Cursor` string

## Request body

- CollectionSearch
  - `search_for` string — Search term
  - `page` integer — Page number. Used for pagination with page_size
  - `page_size` integer — The number of results included on a page. Used for pagination with page
  - `limit` integer — Number of results included on a page. Used for pagination with query
  - `offset` integer — Where to start the listing (the offset of the first result). Used for pagination with limit
  - `order_direction` 'asc' | 'desc' — Direction of ordering
  - `institution` integer — only return collections from this institution
  - `published_since` string — Filter by article publishing date. Will only return articles published after the date. date(ISO 8601) YYYY-MM-DD or date-time(ISO 8601) YYYY-MM-DDTHH:mm:ssZ
  - `modified_since` string — Filter by article modified date. Will only return articles modified after the date. date(ISO 8601) YYYY-MM-DD or date-time(ISO 8601) YYYY-MM-DDTHH:mm:ssZ
  - `group` integer — only return collections from this group

## 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)