Get calendars¶

Fetch all calendars of authenticating MailUser

• HTTP Method: GET
• URL: https://example.domain.tld/api/v1/calendars/
• Require authentication: Yes
• Permission level required: MailUser

Response parameters¶

Parameter	Type	Description
calendars	list	List of all calendars
friendly_name	str	Name (identifier) of calendar
status	str	Status
url	str	URL of CalDAV calendar

Example request (Python)¶

import requests
import json
from pprint import pprint

url = "https://example.domain.tld/api/v1/calendars/"
r = requests.get(url, auth=("ab@vonmail.com","long-auth_token-here"))
try:
    pprint(r.json())
except:
    print(r.text)

Example response (JSON)¶

{'calendars': [{'friendly_name': 'default',
                'status': 'generated',
                'url': 'https://example.domain.tld/radicale/ab@vonmail.com/67763625-112a-405a-a169-598fe63e11af/'},
               {'friendly_name': 'Personal',
                'status': 'generated',
                'url': 'https://example.domain.tld/radicale/ab@vonmail.com/146f3568-1175-414f-b194-45342de3326e/'}]}