Skip to main content
Posts

Get Post

Retrieve a single post by its ID.

Endpoint

GET https://api.postpeer.dev/v1/posts/{postId}

Path Parameters

ParameterTypeDescription
postIdstringThe post ID returned when creating a post

Example

curl "https://api.postpeer.dev/v1/posts/post_abc123" \
  -H "x-access-key: YOUR_API_KEY"

Response

{
  "success": true,
  "post": {
    "postId": "post_abc123",
    "content": "Hello world!",
    "status": "published",
    "scheduledFor": null,
    "timezone": "UTC",
    "mediaItems": [
      {
        "type": "image",
        "url": "https://example.com/image.png",
        "filename": "",
        "size": 0,
        "mimeType": ""
      }
    ],
    "platforms": [
      {
        "platform": "twitter",
        "status": "published",
        "platformPostId": "1234567890",
        "platformPostUrl": "https://twitter.com/you/status/1234567890",
        "publishedAt": "2026-04-15T14:30:00.000Z",
        "errorMessage": null
      }
    ],
    "crosspostingEnabled": false,
    "createdAt": "2026-04-15T14:30:00.000Z",
    "updatedAt": "2026-04-15T14:30:01.000Z"
  }
}

Status Codes

CodeMeaning
200Success
404Post not found

On this page