---
title: "Posts, newest first"
method: GET
path: "/posts"
---

# Posts, newest first

`GET /posts`

## Request

- Base URL: `https://govir.app/api/v1`
- URL: `https://govir.app/api/v1/posts`
- Auth: HTTP bearer

Scope: `read`.

## Query parameters

- `status` 'draft' | 'scheduled' | 'publishing' | 'published' | 'partially_published' | 'failed' | 'needs_review' | 'deleted'
- `account_id` string, uuid
- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `cursor` string: `next_cursor` of the previous page.

## Response `200`

OK

- object
  - `data` Post[]
    - `id` string, uuid
    - `status` 'draft' | 'scheduled' | 'publishing' | 'published' | 'partially_published' | 'failed' | 'needs_review' | 'deleted'
    - `account_id` string, uuid
    - `group_id` string, uuid, nullable
    - `scheduled_at` string, date-time, nullable
    - `published_at` string, date-time, nullable
    - `permalink` string, nullable
    - `topic` string, nullable
    - `reply_control` string, nullable
    - `part_numbers` string
    - `quote` object, nullable
      - `post_id` string, uuid
      - `permalink` string, nullable
      - `username` string
    - `error_code` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `parts` object[]
      - `position` integer
      - `text` string
      - `link_attachment` string, nullable
      - `poll_options` string[], nullable
      - `text_attachment` object, nullable
        - `text` string
        - `link_url` string, nullable
      - `gif` object, nullable
        - `id` string
        - `title` string
        - `width` integer
        - `height` integer
        - `url` string
      - `published` boolean
      - `media` object[]
        - `id` string, uuid
        - `kind` string
        - `url` string, nullable
        - `alt_text` string, nullable
  - `next_cursor` string, nullable

## Other responses

- `400`: The request isn't valid
- `401`: No key, a wrong key, or a revoked one
- `429`: Too many requests; see Retry-After

---

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