REST APIGET

List Posts

Retrieve a paginated list of your posts

GEThttps://post.adaptlypost.com/post/api/v1/social-posts

Returns a paginated list of social media posts ordered by creation date (newest first).

API Key (Bearer token)

Query Parameters

ParameterTypeDescription
limitnumberNumber of posts to return (1-100, default: 20)
offsetnumberNumber of posts to skip (default: 0)
sortOrderstringSort order: NEWEST or OLDEST
statusesPostStatus[]Filter by post statuses (e.g. DRAFT, SCHEDULED, COMPLETED)
platformsPlatformType[]Filter by platforms (e.g. TWITTER, LINKEDIN)
startDatestringFilter posts created after this date (ISO 8601)
endDatestringFilter posts created before this date (ISO 8601)

Post Statuses

StatusDescription
DRAFTSaved but not yet published or scheduled
PENDINGQueued for immediate publishing
SCHEDULEDScheduled for a future date
PUBLISHINGCurrently being published to platforms
COMPLETEDSuccessfully published to at least one platform
FAILEDPublishing failed on all platforms
PARTIAL_FAILUREPublished to some platforms but failed on others
List social posts
curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/social-posts?limit=10&offset=0' \
  --header 'Authorization: Bearer <api-key>'
200
{
  "posts": [
    {
      "id": "post_xyz789",
      "contentType": "TEXT",
      "text": "Hello world!",
      "status": "COMPLETED",
      "scheduledAt": null,
      "timezone": "America/New_York",
      "platforms": [
        {
          "id": "pp_001",
          "platform": "TWITTER",
          "status": "PUBLISHED",
          "accountName": "@yourhandle",
          "publishedAt": "2026-03-14T12:00:00Z"
        }
      ],
      "createdAt": "2026-03-14T11:59:00Z",
      "updatedAt": "2026-03-14T12:00:05Z"
    }
  ],
  "total": 42,
  "hasMore": true
}