> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sydium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List upcoming scheduled posts (optionally within a from/to window)

> Returns the team's scheduled posts, one entry per operation with its target platforms, sorted by scheduled time. Pass `from`/`to` (ISO 8601) to bound a window - for example the current week. Published and failed posts are not included.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/posts
openapi: 3.1.0
info:
  title: Sydium Public API
  version: 1.0.0
servers:
  - url: https://api.sydium.com
security:
  - ApiKey: []
paths:
  /v1/posts:
    get:
      summary: List upcoming scheduled posts (optionally within a from/to window)
      description: >-
        Returns the team's scheduled posts, one entry per operation with its
        target platforms, sorted by scheduled time. Pass `from`/`to` (ISO 8601)
        to bound a window - for example the current week. Published and failed
        posts are not included.
      operationId: listScheduledPosts
      parameters:
        - name: from
          in: query
          required: false
          schema:
            type: string
            format: date-time
        - name: to
          in: query
          required: false
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Scheduled posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduledPostsResponse'
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden (scope/permission)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limited / insufficient tokens
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ScheduledPostsResponse:
      type: object
      required:
        - success
        - data
        - meta
      properties:
        success:
          const: true
        data:
          type: object
          required:
            - posts
          properties:
            posts:
              type: array
              items:
                $ref: '#/components/schemas/ScheduledPost'
        meta:
          type: object
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          const: false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - bad_request
                - unauthorized
                - forbidden
                - insufficient_permissions
                - not_found
                - unprocessable
                - payload_too_large
                - rate_limited
                - invalid_state
                - external_service_error
                - internal_error
            message:
              type: string
        meta:
          type: object
    ScheduledPost:
      type: object
      required:
        - id
        - scheduledFor
        - caption
        - platforms
        - status
      properties:
        id:
          type: string
        scheduledFor:
          type: string
          format: date-time
        caption:
          type: string
          description: >-
            Display text for the post, matching the app's queue - the video
            title for YouTube, the caption for caption-first platforms.
        platforms:
          type: array
          items:
            type: string
        status:
          type: string
          enum:
            - scheduled
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      description: Opaque API key (sk_live_... / sk_test_...)

````