List posts

Get a paginated list of posts for the current organization with optional filters

GET/v1/posts

Query Parameters

social_account_id?string

Filter by social account ID

created_after?string

Filter posts created after this timestamp

Formatdate-time
created_before?string

Filter posts created before this timestamp

Formatdate-time
scheduled_after?string

Filter posts scheduled after this timestamp

Formatdate-time
scheduled_before?string

Filter posts scheduled before this timestamp

Formatdate-time
limit?string

Number of posts per page (1-100)

Default"50"
offset?string

Pagination offset

Default"0"

Response Body

curl -X GET "https://api.outstand.so/v1/posts?social_account_id=123&created_after=2025-01-01T00%3A00%3A00Z&created_before=2025-12-31T23%3A59%3A59Z&scheduled_after=2025-01-01T00%3A00%3A00Z&scheduled_before=2025-12-31T23%3A59%3A59Z&limit=50&offset=0"
{
  "success": true,
  "posts": [
    {
      "id": "9dyJS",
      "orgId": "abc123",
      "publishedAt": "2019-08-24T14:15:22Z",
      "scheduledAt": "2019-08-24T14:15:22Z",
      "isDraft": true,
      "createdAt": "2019-08-24T14:15:22Z",
      "socialAccounts": [
        {
          "id": "9dyJS",
          "nickname": "string",
          "network": "string",
          "username": "string"
        }
      ],
      "containers": [
        {
          "id": "8xKmL",
          "content": "string",
          "media": [
            {
              "url": "string",
              "filename": "string"
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "limit": 0,
    "offset": 0,
    "total": 0
  }
}
{
  "success": false,
  "error": "Invalid payload",
  "details": {
    "content": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}