MyChurch Media API Documentation

SIGN UP

API Introduction

Once you have a MyChurch Media account, and have setup an API key, you'll be able to make GET requests to the URL below.

Your "API key" and "Organisation ID" is required for every request, and should be passed as part of the query string. An example URL is below:

GET https://api.mychurch.media/v1/books?api_token=XXXXXXXX&organisation=XXX

You can make test requests using Hurl.it.


API Response

Data will be returned as a JSON string, with the following fields: 'current_page', 'data', 'from', 'last_page', 'next_page_url', 'path', 'per_page', 'prev_page_url', 'to' and 'total'.


Talks

GET https://api.mychurch.media/v1/talks?api_token=XXXXXXXX&organisation=XXX

Params Type Description
book_id Integer ID of the Bible book
book_slug String Slug of the Bible book (eg: "genesis")
chapter Integer Chapter number
verse Integer Verse number
service_id Integer ID of the service
series_id Integer ID of the series
speaker_id Integer ID of the speaker
q String Search term to match title, desctiption, series or speaker.
limit Integer Limit the number of results returned (1 - 100)
page Integer Specifies which page to return.
order_by String Order by the specified attribute. Defaults to ID.
is_archived Integer Request archived or not archived results (eg: 0 or 1)

Series

GET https://api.mychurch.media/v1/series?api_token=XXXXXXXX&organisation=XXX

Params Type Description
limit Integer Limit the number of results returned (1 - 100).
page Integer Specifies which page to return.
order_by String Order by the specified attribute. Defaults to ID.
is_archived Integer Request archived or not archived results (eg: 0 or 1).

Authors

GET https://api.mychurch.media/v1/authors?api_token=XXXXXXXX&organisation=XXX

Params Type Description
limit Integer Limit the number of results returned (1 - 100).
page Integer Specifies which page to return.
order_by String Order by the specified attribute. Defaults to ID.
is_archived Integer Request archived or not archived results (eg: 0 or 1).

Serices

GET https://api.mychurch.media/v1/services?api_token=XXXXXXXX&organisation=XXX

Params Type Description
limit Integer Limit the number of results returned (1 - 100).
page Integer Specifies which page to return.
order_by String Order by the specified attribute. Defaults to ID.
is_archived Integer Request archived or not archived results (eg: 0 or 1).

Books

GET https://api.mychurch.media/v1/books?api_token=XXXXXXXX&organisation=XXX

Params Type Description
limit Integer Limit the number of results returned (1 - 100).
page Integer Specifies which page to return.
order_by String Order by the specified attribute. Defaults to ID.