Skip to content

ItemTime (Services)

The ItemTime resource in Planning Center Services: how to reach it, its attributes, and what you can query and write.

Property Value
Product Services (pco.services, API version 2018-11-01)
Resource type ItemTime
TypeScript Services.ItemTime, attributes Services.ItemTimeAttributes, schema Services.ItemTimeSchema
Planning Center path /services/v2/songs/{song_id}/last_scheduled_item/{last_scheduled_item_id}/item_times
Planning Center docs ItemTime

How to reach it

Client path Returns Filters Create
pco.services.songs.id(songId).last_scheduled_item.id(itemId).item_times Collection No
pco.services.series.id(seriesId).plans.id(planId).live.id(liveId).current_item_time Collection No
pco.services.series.id(seriesId).plans.id(planId).live.id(liveId).next_item_time Collection No

From a collection, .id(itemTimeId) addresses one ItemTime: pco.services.songs.id(songId).last_scheduled_item.id(itemId).item_times.id(itemTimeId). Collections support where, include, order, and pagination; single resources have get().

Attributes

On Services.ItemTimeAttributes. Every resource also has id and type ('ItemTime') next to its attributes.

Name Type Description
exclude boolean | null
length number | null
length_offset number | null
live_end_at string | null
live_start_at string | null

Relationships and includes

Planning Center documents no includes for this resource.

Relationship Type To Includable
item To one Item No
plan To one Plan No
plan_time To one PlanTime No

Querying

No documented where fields.

No documented order fields.

Edges

This resource has no documented edges.

Writing

Property Value
Create No
Update No
Delete No

Example

import type { Services } from '@mackenly/planningcenterkit';

const songId = '1'; // Song id
const itemId = '1'; // Item id

const page = await pco.services.songs.id(songId).last_scheduled_item.id(itemId).item_times.perPage(25).list();
const items: Services.ItemTime[] = page.data;

Type to search…

↑↓ navigate↵ selectEsc close