Speaker - Publishing API - Planning Center

Example Request

curl https://api.planningcenteronline.com/publishing/v2/speakers

View in API Explorer →

Example Object

{
  "type": "Speaker",
  "id": "1",
  "attributes": {
    "avatar_url": "string",
    "episodes_count": 1,
    "first_name": "string",
    "formatted_name": "string",
    "last_name": "string",
    "name_prefix": "string",
    "name_suffix": "string",
    "speaker_type": "string"
  },
  "relationships": {}
}

Attributes

Name	Type	Description
`avatar_url`	`string`
`episodes_count`	`integer`
`first_name`	`string`
`formatted_name`	`string`
`id`	`primary_key`
`last_name`	`string`
`name_prefix`	`string`
`name_suffix`	`string`
`speaker_type`	`string`

Order By

Parameter	Value	Type	Description
order	first_name	string	prefix with a hyphen (-first_name) 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	`/publishing/v2/speakers`

Reading

HTTP Method	Endpoint
GET	`/publishing/v2/speakers/{id}`

Belongs To

HTTP Method	Endpoint	Association	Details	Filter By
GET	`https://api.planningcenteronline.com/publishing/v2/speakers`	Organization
GET	`https://api.planningcenteronline.com/publishing/v2/episodes/{episode_id}/speakerships/{speakership_id}/speaker`	Speakership