# External Calendar API Endpoint in System Manager - Feature Notes

With the help of this new **External Calendar API Endpoint** feature, users of LearningSpace will be able to process events (including *date, event name,* and *room name*)  using their software integration components and work with the event information in any way they desire, like:

* forwarding them to external calendar applications,
* or presenting it as a static webpage.  


:::warning
**IMPORTANT**

This process is **not a two-way flow** of information: data modified or created in an external calendar cannot be returned/sent back to LearningSpace.

:::

The External Calendar API Endpoint can be enabled by a **toggle** in the System Module, [**General**](/doc/general-system-information-CCiKzgoAzH) tab.  
 ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/a0a0749a-3d3a-4a18-b59d-a5c8f34f0094/76906643.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=b56872c0d8ac70e1a64c222dcaeda06e9e761bcaebe57dac38b6d063f7ad366f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)  

This API endpoint can be queried and provide data from the LearningSpace calendar to display outside the system on a public-facing calendar.

* The calendar is **refreshed hourly.**
* It refers to **today's and future events** for the next 7 days.

With the feature enabled, when starting a **query,** events that

* are **approved**
* **start within that calendar day** (from 00:00 of the day of the query)
* **finish** **on the seventh day** of the query (at 23:59 by the latest), will be displayed.

**API endpoint on the following URL**: `https://<your.learning.space.edu>/w/api/v2/public-calendar.json`  

```java
{
  "events": [
    {
      "isRecurringSeries": false,
      "isPartOfRecurringSeries": true,
      "activity": {
        "color": "neonCarrot",
        "title": "ACLS Testing "
      },
      "eventStart": "2022-06-13T07:00:00Z",
      "note": "Weekly Assessment",
      "rooms": [
        {
          "location": null,
          "name": "Sim 1 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 2 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 3 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 4 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 5 (Sim Room)"
        },
        {
          "location": null,
          "name": "Sim 6 (Sim Room)"
        }
      ],
      "durationMinutes": 180,
      "title": "ACLS Megacode Testing",
      "eventEnd": "2022-06-13T10:00:00Z"
    },
    {
      "isRecurringSeries": false,
      "isPartOfRecurringSeries": false,
      "activity": {
        "color": "neonCarrot",
        "title": "SON C/O 2019 Assessment"
      },
      "eventStart": "2022-06-09T07:00:00Z",
      "note": null,
      "rooms": [
        {
          "location": null,
          "name": "Exam 1 (Exam Room)"
        }
      ],
      "durationMinutes": 135,
      "title": "Effective Assessment and Communication Skills Event",
      "eventEnd": "2022-06-09T09:15:00Z"
    }
  ],
  "eventsTo": "2022-06-16T21:59:59Z",
  "generatedAt": "2022-06-09T05:57:10Z",
  "eventsFrom": "2022-06-08T22:00:00Z"
}
```

  
  


:::warning
LearningSpace does not generate an external calendar application; **the raw data** can be used **to generate entries** to an **external (3rd party) calendar**.  
See details of **how to use the API** on the [**External Calendar API Endpoint**](/doc/external-calendar-api-endpoint-cD2GfRu8Vp) page.

:::


:::tip
See also [How to utilize External Calendar API Endpoint](/doc/d3fa65a6-c9dd-4e1c-90b8-f2406dbb0ccb).

:::

---

**Documents**

- [User Guide](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/user-guide-QPZfKJ0BV1)
- [FAQ](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/faq-AZnS7tDFgM)
- [Release Notes](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/release-notes-fqaGSPScxH)
- [iPad support - Technical information](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/ipad-support-technical-information-iHec00YAzm)
- [Customer Aftercare One-Pager](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/customer-aftercare-one-pager-GOIZYTEgud)
- [Preventing Copy-Paste in LearningSpace](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/preventing-copy-paste-in-learningspace-uEubHwXVD2)