List posts
Returns posts visible to the authenticated caller, with optional filtering by status, profile, provider, and scheduled date range. Supports paginated iteration.
Returns posts visible to the authenticated caller, with optional filtering by status, profile, provider, and scheduled date range. Supports paginated iteration.
Authorization
BearerAuth PostMantis API key from the dashboard. Include as Authorization: Bearer <key>.
In: header
Query Parameters
"pending" | "settled" | "canceled" | "scheduled"date-timedate-time00 <= value201 <= value <= 100Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://loading/api/v1/posts"{ "data": { "data": [ { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "body": "Ship small. Learn fast.", "status": "settled", "createdAt": "2026-05-05T10:00:00.000Z", "updatedAt": "2026-05-05T10:00:00.000Z", "media": [], "deliveries": [ { "profileId": "4339a6bc-9cd3-455e-8f91-df8bc63f12d7", "provider": "x", "profileName": "PostMantis on X", "status": "published", "publishedAt": "2026-05-05T10:01:00.000Z", "providerPostId": "1234567890", "url": "https://x.com/postmantis/status/1234567890", "providerOptions": {} } ] } ], "pagination": { "page": 0, "perPage": 20, "total": 1 } }}{ "type": "https://postmantis.com/problems/unauthorized", "title": "Unauthorized", "status": 401, "detail": "Authentication required.", "code": "unauthorized"}{ "type": "https://postmantis.com/problems/rate-limited", "title": "Too many requests", "status": 429, "detail": "Too many requests.", "code": "rateLimited"}API Overview
Public API for posting, scheduling, uploads, and delivery inspection.
Create a post POST
Creates a publish-now post when `post.scheduledAt` is omitted, or a scheduled post when `post.scheduledAt` is a future ISO-8601 datetime. Accepts JSON or multipart/form-data (for direct file uploads). Posts must have a body, media, or both. Use `/uploads` first if you want server-verified artifacts.