Sign in

v52

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-21450373.3 KB
posts

Get post by ID

Retrieve detailed information about a specific post

get/v1/posts/{postId}

Path parameters

postIdstring required

Unique identifier of the post

Query parameters

boolean
OR
string

Include full content fields (markdown, json, staticHtml). Default: false

Response

Post details retrieved successfully

idstring required

Unique identifier for the post

titlestring required

Title of the post

imageUrlstring uri

Optional URL to the post's main image

publishedAtstring

Epoch timestamp when the post was published

updatedAtstring

Epoch timestamp when the post was last updated

subtitlestring

Optional subtitle or brief summary

slugstring required

URL-friendly identifier for the post; accessible at paragraph.com/@[publicationSlug]/[slug]

staticHtmlstring

Rendered HTML content of the post

jsonstring

TipTap JSON representation of the post content structure. This is the source of truth that the staticHtml and markdown is generated from

markdownstring

Markdown source of the post content

coinIdstring

ID of the associated coin, if the post is coined

categoriesstring[]

Categories/tags associated with this post

authorIdsstring[]

IDs of the authors of this post

viewsnumber

Total views. Only included when fetching your own posts via GET /v1/posts

status'published' | 'draft' | 'scheduled' | 'archived'

Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state — publishedAt is preserved across unpublishing.