List Posts

Retrieve a paginated list of your social media posts.

Request

Fetch your post history with pagination, status filters, and platform filters.

Permission required: posts:read

Query Parameters

limitintegerOptional

Default: 50

Maximum number of posts to return per page. Range: 1–100.

offsetintegerOptional

Default: 0

Number of posts to skip. Used for pagination.

statusstringRequired

Filter by post status. Values: DRAFT, SCHEDULED, PROCESSING, PUBLISHED, FAILED, PARTIALLY_PUBLISHED. Case-insensitive.

platformstringRequired

Filter by target platform. Values: TWITTER, INSTAGRAM, LINKEDIN, FACEBOOK, TIKTOK, YOUTUBE, PINTEREST, SNAPCHAT. Only returns posts linked to accounts on this platform.

Example Request

curl "https://app.ewasl.com/api/v1/posts?limit=10&status=published" \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

Response

Returns a paginated list of post objects.

dataarray

List of post objects.

metaobject

Pagination metadata.

Response Example

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "content": "Check out our new feature!",
      "status": "PUBLISHED",
      "platforms": ["twitter", "linkedin"],
      "mediaUrls": [],
      "scheduledAt": null,
      "publishedAt": "2026-02-14T10:05:00Z",
      "createdAt": "2026-02-14T10:00:00Z",
      "updatedAt": "2026-02-14T10:05:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "content": "Draft post for next week",
      "status": "DRAFT",
      "platforms": ["instagram"],
      "mediaUrls": ["https://example.com/photo.jpg"],
      "scheduledAt": null,
      "publishedAt": null,
      "createdAt": "2026-02-13T15:30:00Z",
      "updatedAt": "2026-02-13T15:30:00Z"
    }
  ],
  "meta": {
    "total": 245,
    "offset": 0,
    "limit": 10,
    "next": "/api/v1/posts?offset=10&limit=10"
  }
}