---
title: "Get a post"
method: GET
path: "/api/posts/{groupId}"
tags: ["Posts"]
---

# Get a post

`GET /api/posts/{groupId}`

## Request

- Base URL: `https://api-app.postnext.io`
- URL: `https://api-app.postnext.io/api/posts/{groupId}`
- Auth: API key in header `x-api-key`

## Path parameters

- `groupId` string, required

## Response `200`

The post group with its provider posts

- PostDetailEnvelope
  - `success` boolean
  - `data` object
    - `group` PostGroup
      - `id` string: Post group uuid.
      - `_id` string: Mongo ObjectId.
      - `userId` string
      - `teamId` string
      - `title` string
      - `description` string
      - `imageUrl` string, uri
      - `providers` object
      - `tags` string[]
      - `scheduledTime` string, date-time
      - `status` 'DRAFT' | 'SCHEDULED' | 'PUBLISHING' | 'PUBLISHED' | 'FAILED' | 'APPROVAL'
      - `assigneeId` string
      - `watchers` string[]
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `providerPosts` object[]

## Other responses

- `401`: Missing or invalid API key
- `404`: Post not found or access denied

---

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