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