> ## Documentation Index
> Fetch the complete documentation index at: https://pocketmusala.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer API

> Sync mosque profile content, prayer times, announcements, and events from a trusted external system.

PocketMusala's Developer API lets a mosque-owned external server keep approved
mosque data current without sharing a user's PocketMusala login.

The API is intended for weekly or low-frequency server-to-server syncs from a
trusted mosque website, legacy mosque app, or local masjid management system.
It is not a public marketplace API and it does not expose mosque ownership,
admin management, verification, entitlement, deletes, billing, or moderation
bypasses.

## What You Can Sync

* Public mosque profile fields, including name, address, coordinates, time
  zone, status message, donation link, and prayer calculation parameters.
* Manual prayer-time rows, including multiple `jummah` rows when a mosque has
  more than one Friday prayer.
* Mosque announcements.
* Mosque events.
* Current sync snapshot and capability metadata.

## What Stays Inside PocketMusala

API key creation, scope selection, rotation, revocation, and key status are
managed only inside the authenticated PocketMusala Developer API portal. The
public REST API has no endpoint for creating keys or changing permissions.

## Base URL

Use the official PocketMusala API base URL:

```text theme={null}
https://api.pocketmusala.com
```

Endpoint paths are relative to that base URL. For example:

```text theme={null}
/v1/mosques/{mosqueId}/profile
```

## Start Here

Use the quickstart to run a first weekly sync, then use the API reference for
exact request and response shapes.