---
title: "List publications"
method: GET
path: "/publications"
tags: ["Publication"]
---

# List publications

`GET /publications`

## Request

- Base URL: `https://telescope.ac/api`
- URL: `https://telescope.ac/api/publications`
- Auth: none declared

Returns a paginated list of publications for a space, with their published drafts.

## Query parameters

- `space_id` string, uuid, required: Space ID to list publications for.
- `page` integer: Page number.
- `per_page` integer: Items per page.

## Headers

- `Authorization` string

## Response `200`

OK

- GetPublicationsOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `page` integer, required
  - `per_page` integer, required
  - `publications` PublicationListItem[], nullable, required
    - `alt` string, required
    - `created_at` string, date-time
    - `deleted_at` string, date-time
    - `flagged_at` string, date-time
    - `id` string, uuid
    - `language` string, required
    - `last_draft` Draft
      - `cover_image_url` string, nullable, required
      - `created_at` string, date-time, nullable, required
      - `deleted_at` string, date-time
      - `description` string, nullable, required
      - `format` 'html' | 'md', required
      - `id` string, uuid, required
      - `publication_id` string, uuid, required
      - `text` string, required
      - `title` string, required
      - `updated_at` string, date-time, nullable, required
      - `user_id` string, uuid, required
    - `last_draft_id` string, uuid
    - `metadata` Jsonb, required
    - `published_at` string, nullable, required
    - `published_draft` Draft
      - `cover_image_url` string, nullable, required
      - `created_at` string, date-time, nullable, required
      - `deleted_at` string, date-time
      - `description` string, nullable, required
      - `format` 'html' | 'md', required
      - `id` string, uuid, required
      - `publication_id` string, uuid, required
      - `text` string, required
      - `title` string, required
      - `updated_at` string, date-time, nullable, required
      - `user_id` string, uuid, required
    - `published_draft_id` string, uuid
    - `space_category_id` string, uuid
    - `space_id` string, uuid
    - `spam_reasons` string
    - `spam_score` integer
    - `topic_ids` Jsonb
    - `translations` PublicationTranslationRef[], nullable
      - `id` string, uuid, required
      - `language` string, required
      - `published` boolean, required
    - `update_published_at` string
    - `updated_at` string, date-time
    - `user_id` string, uuid, required
  - `total` integer, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/telescope/apis/telescope-api.md) - [All operations](https://skmtc.dev/telescope/apis/telescope-api/llms.txt) - [OpenAPI document](https://skmtc.dev/telescope/apis/telescope-api/revisions/e4bd44d7f2b0?raw)