Prayer Circle API

The Prayer Circle API lets individuals, churches, and ministries integrate live prayer content directly into their own websites and applications.

🙏 Post prayer requests from your personal blog. Embed your church's live prayer wall on your ministry site. Pull in real-time prayer and sermon content from Prayer Circle into your existing web presence — no app store, no code changes, just your API key.

The API is built on Parse Server. If you've used the Parse REST API before you'll feel right at home. Every request is authenticated with your personal session token, which you get by logging in through the app or organisation dashboard.

Authentication

Every API request must include two headers:

X-Parse-Application-Id — the public app identifier (same for everyone)
X-Parse-Session-Token — your personal API key (keep this private)

⚠️ Your session token has full access to your account. Don't include it in client-side JavaScript that's visible to other users. Use it in server-side code or private embed scripts only.

Get Your API Key

Download the Prayer Circle App

Create your account on App Store or Google Play. Your account gives you access to the full API.

Log in to the Dashboard

Visit prayercircle.co.uk/organization-dashboard and sign in with your email and password.

Copy Your API Key

Go to the My API Key tab. Your session token is displayed there — click Copy to grab it.

Start Building

Use the examples below to post prayers, embed your prayer wall, or pull in content from your ministry.

Base URL & Required Headers

Base URL

https://prayercircle.co.uk/parse

Required headers (every request)

X-Parse-Application-Id: 50150ad05aa431ddcf1d55db340faff2096e00e4
X-Parse-Session-Token:  YOUR_API_KEY
Content-Type:           application/json

Prayers

Manage prayer requests. You can create, read, and delete your own prayers.

POST

/classes/Prayer

Create a new prayer request

GET

/classes/Prayer

List prayers (supports filtering, sorting, pagination)

GET

/classes/Prayer/:objectId

Fetch a single prayer by ID

DELETE

/classes/Prayer/:objectId

Delete one of your own prayer requests

Prayer Fields

Field	Type	Description
title	String	Short title for the prayer request required
prayerText	String	Full prayer request body required
privacy	String	`"public"` or `"private"` — defaults to `"public"`
category	String	Optional: `"healing"`, `"thanksgiving"`, `"guidance"`, etc.
anonymous	Boolean	Hide your name from the public display

Feed Posts

Organisation feed posts — announcements, updates, and devotionals from your ministry.

GET

/classes/FeedPost

List all feed posts (use query params to filter by organisation)

POST

/classes/FeedPost

Create a new feed post (requires org admin access)

Sermons

Access sermon content posted by organisations on Prayer Circle.

GET

/classes/Sermon

List sermons — use order=-createdAt to get latest first

GET

/classes/Sermon/:objectId

Fetch a single sermon by ID

Users

Fetch your own profile information.

GET

/users/me

Get the currently authenticated user

GET

/users/:objectId

Get a public user profile by ID

Query Parameters

All list endpoints support standard Parse query parameters:

Parameter	Type	Description
where	JSON	Filter objects — e.g. `?where={"privacy":"public"}`
order	String	Sort — e.g. `?order=-createdAt` (prefix `-` for descending)
limit	Number	Max results to return (default 100, max 1000)
skip	Number	Offset for pagination — e.g. `skip=20&limit=20`
include	String	Pointer fields to expand — e.g. `?include=user`
count	1	Include total count in response — `?count=1`

Example: Post a Prayer

// JavaScript (fetch)
const response = await fetch('https://prayercircle.co.uk/parse/classes/Prayer', {
  method: 'POST',
  headers: {
    'X-Parse-Application-Id': '50150ad05aa431ddcf1d55db340faff2096e00e4',
    'X-Parse-Session-Token':  'YOUR_API_KEY',
    'Content-Type':           'application/json',
  },
  body: JSON.stringify({
    title:      'Prayer for my family',
    prayerText: 'Lord, please bring peace and healing to my household...',
    privacy:    'public',
    category:   'healing',
  }),
});

const data = await response.json();
// { objectId: "abc123", createdAt: "2026-06-17T10:00:00.000Z" }
console.log('Prayer posted:', data.objectId);

# cURL
curl -X POST \
  'https://prayercircle.co.uk/parse/classes/Prayer' \
  -H 'X-Parse-Application-Id: 50150ad05aa431ddcf1d55db340faff2096e00e4' \
  -H 'X-Parse-Session-Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Prayer for my family",
    "prayerText": "Lord, please bring peace and healing...",
    "privacy": "public"
  }'

# Python (requests)
import requests

url     = "https://prayercircle.co.uk/parse/classes/Prayer"
headers = {
    "X-Parse-Application-Id": "50150ad05aa431ddcf1d55db340faff2096e00e4",
    "X-Parse-Session-Token":  "YOUR_API_KEY",
    "Content-Type":           "application/json",
}
payload = {
    "title":      "Prayer for my family",
    "prayerText": "Lord, please bring peace and healing...",
    "privacy":    "public",
}

r = requests.post(url, json=payload, headers=headers)
print(r.json())  # {'objectId': 'abc123', 'createdAt': '...'}

Example: Fetch Your Prayers

// Get your 10 most recent public prayers
const userId = 'YOUR_USER_ID'; // from the Dashboard → My API Key tab

const where = JSON.stringify({
  user: { __type: 'Pointer', className: '_User', objectId: userId },
  privacy: 'public',
});

const url = `https://prayercircle.co.uk/parse/classes/Prayer`
         + `?where=${encodeURIComponent(where)}`
         + `&order=-createdAt&limit=10&include=user`;

const res  = await fetch(url, { headers: { ... } });
const data = await res.json();

data.results.forEach(p => {
  console.log(p.title, p.prayerText, p.createdAt);
});

The easiest way to display your prayer requests on your website. One script tag, one div — and your live prayer wall appears automatically, styled to match Prayer Circle.

ℹ️ Find your User ID and auto-generated embed code in the Dashboard → My API Key tab.

Minimal embed

<!-- Add anywhere in your <body> -->
<div class="pc-prayers"
     data-user="YOUR_USER_ID"
     data-theme="light"
     data-limit="10"></div>
<script src="https://prayercircle.co.uk/embed/prayers.js"></script>

Widget Options

Attribute	Values	Description
data-user	String	Your User ID required
data-theme	"light" / "dark"	Widget colour scheme (default: "light")
data-limit	Number	Number of prayers to show (default: 5)
data-show-pray	"true" / "false"	Show the Pray Along button (default: "true")
data-category	String	Filter by category: "healing", "thanksgiving", etc.

iFrame Embed

When you can't add custom scripts (some website builders and CMSs), use an iframe instead:

<iframe
  src="https://prayercircle.co.uk/embed/prayers?user=YOUR_USER_ID&theme=light"
  width="100%"
  height="600"
  frameborder="0"
  style="border-radius:12px;border:1px solid #e5e7eb"
></iframe>

Organisation API

If you manage a church or ministry organisation on Prayer Circle, you can pull your organisation's content by filtering on your Organisation ID.

Fetch your org's feed posts

const orgId = 'YOUR_ORG_ID'; // from the Dashboard → My Organisations tab

const where = JSON.stringify({
  organisation: { __type: 'Pointer', className: 'FeedOrganization', objectId: orgId }
});

const url = `https://prayercircle.co.uk/parse/classes/FeedPost`
         + `?where=${encodeURIComponent(where)}&order=-createdAt&limit=5`;

const res  = await fetch(url, { headers: { ... } });
const data = await res.json();
// data.results → array of posts

Organisation Feed Embed

Display your entire organisation feed — prayers, posts, and sermons — on your church website with one snippet. The full embed code is generated for you in the Organisation Dashboard.

<!-- Place on your church website -->
<div class="pc-feed"
     data-org="YOUR_ORG_ID"
     data-theme="light"></div>
<script src="https://prayercircle.co.uk/embed/org.js"></script>

Ready to get started?

Open Dashboard →