---
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}`

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.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)