---
title: "Get posts"
method: GET
path: "/api/v1/posts"
---

# Get posts

`GET /api/v1/posts`

Returns a list of posts with at least one content in the published status.

## Query parameters

- `language` string — Primary Key (UUID)

## Response `200`

- object
  - `posts` PostResponse[]
    - `id` string, required — Primary Key (UUID)
    - `contents` ListContentResponse[], required
      - `id` string, required — Primary Key (UUID)
      - `slug` string, required — Slug
      - `title` string, required — Title
      - `subtitle` string — Subtitle
      - `body` string, required — Body
      - `bodyHtml` string, required — Body HTML
      - `status` string, required — Status
      - `language` string, required — Lowercase language code
      - `version` integer, required — Version
      - `coverUrl` string — Cover URL
      - `metaTitle` string — Seo title
      - `metaDescription` string — Seo description
      - `publishedAt` string, required — Date the version of the post was published
      - `author` Author, required
        - `id` string, required — Primary Key (UUID)
        - `name` string, required — Name
        - `avatarUrl` string — Avatar URL
        - `bio` string — Used as Person.description in JSON-LD
        - `bioUrl` string — Used as Person.sameAs in JSON-LD
        - `employer` string — Used as worksFor in JSON-LD

## Changes

> 18 revisions in range; 1 could not be searched.

- **2024-10-31** `205e31be53ec` — 1 info
  - endpoint added
- **2023-10-08** `8c6ac08cbd78` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/collectionscms/apis/collections-api/changes/api/v1/posts/get.md)

---

[API](https://skmtc.dev/collectionscms/apis/collections-api.md) · [All operations](https://skmtc.dev/collectionscms/apis/collections-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/collectionscms/collections-api/revisions/88765b3763ab/schema)