SongSchedule - Services API

Example Request

curl https://api.planningcenteronline.com/services/v2/songs/{song_id}/song_schedules

View in API Explorer →

Example Object

{
  "type": "SongSchedule",
  "id": "1",
  "attributes": {
    "arrangement_name": "string",
    "key_name": "string",
    "plan_dates": "string",
    "plan_sort_date": "string",
    "plan_visible": true,
    "service_type_name": "string"
  },
  "relationships": {
    "arrangement": {
      "data": {
        "type": "Arrangement",
        "id": "1"
      }
    },
    "key": {
      "data": {
        "type": "Key",
        "id": "1"
      }
    },
    "plan": {
      "data": {
        "type": "Plan",
        "id": "1"
      }
    },
    "service_type": {
      "data": {
        "type": "ServiceType",
        "id": "1"
      }
    },
    "item": {
      "data": {
        "type": "Item",
        "id": "1"
      }
    }
  }
}

Attributes

Name	Type	Description
`arrangement_name`	`string`
`id`	`primary_key`
`key_name`	`string`
`plan_dates`	`string`
`plan_sort_date`	`string`
`plan_visible`	`boolean`
`service_type_name`	`string`

Relationships

Name	Type	Association Type
arrangement	Arrangement	to_one
key	Key	to_one
plan	Plan	to_one
service_type	ServiceType	to_one
item	Item	to_one

Order By

Parameter	Value	Type	Description
order	plan_sort_date	string	prefix with a hyphen (-plan_sort_date) to reverse the order

Pagination

Name	Parameter	Type	Description
per_page	per_page	integer	how many records to return per page (min=1, max=100, default=25)
offset	offset	integer	get results from given offset

Endpoints

Listing

HTTP Method	Endpoint
GET	`/services/v2/songs/{song_id}/song_schedules`

Reading

HTTP Method	Endpoint
GET	`/services/v2/songs/{song_id}/song_schedules/{id}`

Belongs To

HTTP Method	Endpoint	Association	Details	Filter By
GET	`https://api.planningcenteronline.com/services/v2/songs/{song_id}/song_schedules`	Song		`three_most_recent`