> ## 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.

# List mosque announcements



## OpenAPI

````yaml /openapi/pocketmusala-developer-api-v1.yaml get /v1/mosques/{mosqueId}/announcements
openapi: 3.1.0
info:
  title: PocketMusala Developer API
  version: 1.0.0
  summary: Mosque sync API for trusted external servers.
  license:
    name: Proprietary
    identifier: LicenseRef-PocketMusala-Proprietary
  description: >
    The PocketMusala Developer API lets trusted external servers sync approved
    mosque profile, prayer, announcement, and event data. API key creation,
    scope selection, rotation, and revocation stay inside the authenticated
    PocketMusala Developer API portal.
servers:
  - url: https://api.pocketmusala.com
    description: Official API
security:
  - bearerAuth: []
tags:
  - name: Health
    description: Service availability endpoints.
  - name: Capabilities
    description: Supported resources, fields, scopes, and prayer keys.
  - name: Snapshot
    description: Combined read endpoints for weekly sync verification.
  - name: Profile
    description: Approved public mosque profile fields.
  - name: Announcements
    description: Mosque announcement sync endpoints.
  - name: Prayers
    description: Manual prayer-time row sync endpoints.
  - name: Events
    description: Mosque event sync endpoints.
paths:
  /v1/mosques/{mosqueId}/announcements:
    get:
      tags:
        - Announcements
      summary: List mosque announcements
      operationId: listMosqueAnnouncements
      parameters:
        - $ref: '#/components/parameters/MosqueId'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/RequestId'
      responses:
        '200':
          description: Announcements for the mosque.
          content:
            application/json:
              schema:
                type: object
                required:
                  - announcements
                properties:
                  announcements:
                    type: array
                    items:
                      $ref: '#/components/schemas/Announcement'
        4XX:
          $ref: '#/components/responses/Error'
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    MosqueId:
      name: mosqueId
      in: path
      required: true
      schema:
        type: string
        format: uuid
    Limit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 100
      description: Maximum rows to return. Defaults to 50 where supported.
    RequestId:
      name: X-Request-Id
      in: header
      required: false
      schema:
        type: string
        minLength: 1
      description: Partner-generated request id used for logs and support.
  schemas:
    Announcement:
      type: object
      required:
        - id
        - title
        - body
        - createdAt
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        body:
          type: string
        flairType:
          type:
            - string
            - 'null'
        latitude:
          type:
            - number
            - 'null'
        longitude:
          type:
            - number
            - 'null'
        createdAt:
          type: string
          format: date-time
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - requestId
            - troubleshooting
          properties:
            code:
              type: string
              examples:
                - missing_api_key
                - malformed
                - revoked
                - wrong_community
                - missing_scope
                - invalid_argument
                - invalid_prayer_time
                - not_found
            message:
              type: string
            requestId:
              type: string
            troubleshooting:
              $ref: '#/components/schemas/TroubleshootingState'
    TroubleshootingState:
      type: object
      required:
        - code
        - severity
        - adminSummary
        - developerSummary
      properties:
        code:
          type: string
        severity:
          type: string
          enum:
            - success
            - warning
            - error
        adminSummary:
          type: string
        developerSummary:
          type: string
  responses:
    Error:
      description: Stable JSON error envelope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: PocketMusala Developer API key from the authenticated portal.

````