---
title: "Public Articles"
method: GET
path: "/articles"
tags: ["articles"]
---

# Public Articles

`GET /articles`

Returns a list of public articles

## Query parameters

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

## Headers

- `X-Cursor` string

## Response `200`

OK. An array of articles

- Article[]
  - `id` integer, required — Unique identifier for article
  - `title` string, required — Title of article
  - `doi` string, required — DOI
  - `handle` string, required — Handle
  - `url` string, url, required — Api endpoint for article
  - `url_public_html` string, url, required — Public site endpoint for article
  - `url_public_api` string, url, required — Public Api endpoint for article
  - `url_private_html` string, url, required — Private site endpoint for article
  - `url_private_api` string, url, required — Private Api endpoint for article
  - `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
  - `thumb` string, url, required — Thumbnail image
  - `defined_type` integer, required — Type of article identifier
  - `defined_type_name` string, required — Name of the article type identifier
  - `resource_doi` string, required — Deprecated by related materials. Not applicable to regular users. In a publisher case, this is the publisher article DOI.
  - `resource_title` string, required — Deprecated by related materials. Not applicable to regular users. In a publisher case, this is the publisher article title.
  - `created_date` string, required — Date when article was created
  - `modified_date` string — Date when article was last modified
  - `published_date` string — Date when article was first published, null if not published
  - `group_id` integer — Group ID of the article

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity. Syntax is correct but one of the parameters isn't correctly processed
- `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)