---
title: "List schedule targets"
method: GET
path: "/scheduling/v1/schedule_targets/{schedule_id}"
tags: ["Schedules"]
---

# List schedule targets

`GET /scheduling/v1/schedule_targets/{schedule_id}`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/scheduling/v1/schedule_targets/{schedule_id}`
- Auth: HTTP bearer

Returns the sites or assets a schedule applies to, along with the recurrence for each. Results are filtered by the caller's access — only items the caller has permission to view are returned. total_count reflects the full number of sites or assets on the schedule and may exceed the number of items returned.

## Path parameters

- `schedule_id` string, required

## Query parameters

- `page_size` integer
- `page_token` string
- `search_query` string

## Response `200`

A successful response.

- S12SchedulingV1ListScheduleTargetsResponse: ListScheduleTargetsResponse is the response for ListScheduleTargets.
  - `targets` S12SchedulingV1ScheduleTargetDetail[]: The sites or assets the schedule applies to, filtered by the caller's access, with the recurrence for each.
    - union: A site or asset the schedule applies to, along with how the schedule recurs for it. Exactly one of site or asset is set.
      - object: The schedule applies to a site.
        - `recurrence` string: RFC 5545 RRULE describing how the schedule recurs for this site or asset. May be adjusted to the site's local time zone, so it can differ between sites or assets.
        - `site` S12SchedulingV1SiteScheduleTarget, required: SiteScheduleTarget is a site a schedule applies to.
          - `id` string: Unique ID of the site.
          - `name` string: Name of the site.
          - `timezone` string: IANA time zone of the site (e.g. "Australia/Sydney"). Empty when the site has no time zone set.
      - object: The schedule applies to an asset.
        - `recurrence` string: RFC 5545 RRULE describing how the schedule recurs for this site or asset. May be adjusted to the site's local time zone, so it can differ between sites or assets.
        - `asset` S12SchedulingV1AssetScheduleTarget, required: AssetScheduleTarget is an asset a schedule applies to.
          - `id` string: System-generated unique ID of the asset.
          - `code` string: The asset's code - its user-defined unique identifier.
          - `display_name` string: Display name of the asset.
          - `type` S12SchedulingV1AssetTargetType: AssetTargetType is the type of an asset (e.g. "Forklift").
            - `id` string: Unique ID of the asset type.
            - `name` string: Name of the asset type.
          - `site` S12SchedulingV1AssetSite: AssetSite is the site an asset is linked to.
            - `id` string: Unique ID of the site.
            - `name` string: Name of the site.
            - `timezone` string: IANA time zone of the site (e.g. "Australia/Sydney"). Empty when the site has no time zone set.
  - `total_count` integer: Total number of sites or assets the schedule applies to, regardless of the caller's access or any search_query filter. This value may exceed the number of items returned when the caller does not have permission to view all sites or assets, or when a search_query is set.
  - `next_page_token` string: Token for fetching the next page. Token is empty when there are no more results.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
