GET https://www.appointment.one/api/v1/calendar/CALENDAR_ID

The calendar details get request is used to obtain details associated with a specific calendar.

Parameters

none

Response Codes

Expect the following http respond codes:

• 200 - Success
• 401 - Authentication failure. Occurs if the Authentication header is misused, if the API key has been revoked, or if the user/account is no longer active on Appointment.one
• 404 - Specified event cannot be found

Response Values

• id - Appointment unique ID
• type - Calendar type, one of Google Apps, Office 365, or Exchange
• default - Whether this is the default calendar associated with the user account
• state - Calendar state, one of ok or access_error
• date_added - Unix timestamp showing date the calendar was added

Example Response

Returns a json object with the following makeup.

{
  "id": "test1@example.com",
  "type": "Google Apps",
  "default": false,
  "state": "ok",
  "date_added": "1489610800",
  "links": [
    {
      "rel": "self",
      "href": "/api/v1/calendar/test1@example.com",
      "verbs": [
        "GET",
        "DELETE"
      ]
    }
  ]
}

Examples

curl

> curl -vk \
       -H 'Content-Type: application/json' \
       -H 'Authorization: API_KEY_HERE' \
       -X GET 'https://www.appointment.one/api/v1/calendar/CALENDAR_ID'

python

>>> import requests

>>> r = requests.get('https://www.appointment.one/api/v1/calendar/CALENDAR_ID', 
                    headers= {'Authorization': 'API_KEY_HERE'})