# Get published shift schedules

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/rest/schedule/{shopId}/:
    get:
      summary: Get published shift schedules
      deprecated: false
      description: >-
        Retrieve published shift schedules for a specific merchant with optional
        filters
      operationId: getPublishedSchedules
      tags:
        - Scheduling
        - scheduling-api
      parameters:
        - name: shopId
          in: path
          description: Shop ID (internal ID or Shopify shop name)
          required: true
          example: ''
          schema:
            type: string
        - name: userId
          in: query
          description: Filter by Shopify user ID
          required: false
          schema:
            type: string
        - name: locationId
          in: query
          description: Filter by Shopify location ID
          required: false
          schema:
            type: integer
        - name: from
          in: query
          description: Start date (UTC ISO format)
          required: true
          schema:
            type: string
            format: date-time
        - name: to
          in: query
          description: End date (UTC ISO format)
          required: true
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Successfully retrieved shift schedules
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    employeeName:
                      type: string
                    shopifyUserId:
                      type: string
                      nullable: true
                    location:
                      type: string
                    position:
                      type: string
                      nullable: true
                    date:
                      type: string
                      format: date
                    startTime:
                      type: string
                      format: date-time
                    endTime:
                      type: string
                      format: date-time
                    breaks:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: number
                          name:
                            type: string
                          type:
                            type: string
                          durationMins:
                            type: number
                          frequencyMins:
                            type: number
                          default:
                            type: boolean
                          required:
                            type: boolean
                        x-apidog-orders:
                          - id
                          - name
                          - type
                          - durationMins
                          - frequencyMins
                          - default
                          - required
                  x-apidog-orders:
                    - employeeName
                    - shopifyUserId
                    - location
                    - position
                    - date
                    - startTime
                    - endTime
                    - breaks
          headers: {}
          x-apidog-name: ''
        '400':
          description: Bad Request
          headers: {}
          x-apidog-name: ''
        '401':
          description: Unauthorized
          headers: {}
          x-apidog-name: ''
        '403':
          description: Forbidden
          headers: {}
          x-apidog-name: ''
        '404':
          description: Not Found
          headers: {}
          x-apidog-name: ''
        '429':
          description: Rate Limit Exceeded
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: Scheduling
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/763618/apis/api-33094542-run
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

```