Posts

List posts

Get a paginated list of posts for the current organization with optional filters. Results include post content, containers, scheduling status, and publishing state. Each returned post includes its unique ID, which can be used with GET /v1/posts/:id for full details or DELETE /v1/posts/:id to cancel a scheduled post.

Filtering:

  • tenant_id - Filter by tenant ID for multi-tenant applications (exact match). Posts carry no tenant of their own, so a post matches when at least one of its target social accounts has that tenant ID. tenantId is accepted as an alias for parity with GET /v1/social-accounts.
  • social_account_id - Filter by social account ID (posts targeting that account). Accepts the encoded ID returned by the API, or a raw numeric ID.
  • created_after / created_before - Creation timestamp range (ISO 8601)
  • scheduled_after / scheduled_before - Scheduled timestamp range (ISO 8601)
  • All filters combine with AND.

Note that filters select posts: a matching post is returned with its full socialAccounts array, so a post fanned out across several tenants will list all of its accounts. When tenant_id and social_account_id are combined they must be satisfied by the same account, so pairing a tenant with an account outside it returns no results rather than matching through a sibling account.

Pagination: use limit and offset. pagination.total is the total number of posts matching the filters across all pages; pagination.count is the number of posts in the current page.

get/v1/posts

Request

  • Base URL: https://api.outstand.so
  • URL: https://api.outstand.so/v1/posts
  • Auth: none declared

Query parameters

social_account_idstring
Example:9dyJS

Filter by social account ID. Accepts the encoded ID returned by the API, or a raw numeric ID.

tenant_idstring
Example:tenant_123

Filter by tenant ID for multi-tenant applications (exact match). Returns posts targeting at least one social account with this tenant ID.

tenantIdstring
Example:tenant_123

Alias for tenant_id, accepted for parity with GET /v1/social-accounts. If both are provided, tenant_id wins.

created_afterstring date-time
Example:2025-01-01T00:00:00Z

Filter posts created after this timestamp

created_beforestring date-time
Example:2025-12-31T23:59:59Z

Filter posts created before this timestamp

scheduled_afterstring date-time
Example:2025-01-01T00:00:00Z

Filter posts scheduled after this timestamp

scheduled_beforestring date-time
Example:2025-12-31T23:59:59Z

Filter posts scheduled before this timestamp

limitstring
Example:50

Number of posts per page (1-100)

offsetstring
Example:0

Pagination offset

Response

Posts retrieved successfully

successboolean required

Example response

{
  "success": true,
  "posts": [
    {
      "id": "9dyJS",
      "orgId": "abc123",
      "socialAccounts": [
        {
          "id": "9dyJS",
          "status": "published",
          "platformPostId": "123456789",
          "platformPostUrl": "https://www.instagram.com/p/DAbCdEfGhIj/",
          "publishedAt": "2025-01-15T10:30:00Z"
        }
      ],
      "containers": [
        {
          "id": "8xKmL"
        }
      ]
    }
  ],
  "data": [
    {
      "id": "9dyJS",
      "orgId": "abc123",
      "socialAccounts": [
        {
          "id": "9dyJS",
          "status": "published",
          "platformPostId": "123456789",
          "platformPostUrl": "https://www.instagram.com/p/DAbCdEfGhIj/",
          "publishedAt": "2025-01-15T10:30:00Z"
        }
      ],
      "containers": [
        {
          "id": "8xKmL"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.