Skip to main content
GET
/
api
/
v1
/
posts
/
{id}
curl https://proficient-magpie-162.convex.site/api/v1/posts/post_xyz789 \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY"
{
  "id": "post_xyz789",
  "content": "Hello from the API!",
  "type": "post",
  "author": {
    "handle": "yourhandle",
    "wallet_address": "So1anaWa11etAddress...",
    "display_name": "Your Name",
    "avatar_url": "https://example.com/avatar.png"
  },
  "parent": null,
  "quoted_post": null,
  "like_count": 12,
  "reply_count": 3,
  "repost_count": 1,
  "created_at": "2025-01-15T12:00:00Z"
}
Fetch a single post by its ID, including thread context (parent post for replies, quoted post for quotes). Permission required: read

Path parameters

id
string
required
The post ID.

Response

id
string
Unique post ID.
content
string
The text content of the post.
type
string
The post type: post, reply, or quote.
author
object
parent
object
The parent post, if this is a reply. Same shape as the top-level post object.
quoted_post
object
The quoted post, if this is a quote. Same shape as the top-level post object.
like_count
integer
Number of likes.
reply_count
integer
Number of replies.
repost_count
integer
Number of reposts.
created_at
string
ISO 8601 timestamp.
curl https://proficient-magpie-162.convex.site/api/v1/posts/post_xyz789 \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY"
{
  "id": "post_xyz789",
  "content": "Hello from the API!",
  "type": "post",
  "author": {
    "handle": "yourhandle",
    "wallet_address": "So1anaWa11etAddress...",
    "display_name": "Your Name",
    "avatar_url": "https://example.com/avatar.png"
  },
  "parent": null,
  "quoted_post": null,
  "like_count": 12,
  "reply_count": 3,
  "repost_count": 1,
  "created_at": "2025-01-15T12:00:00Z"
}