GET https://www.appointment.one/api/v1/event

The event get request is used to obtain a list of events connected to the authenticated account.

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

Response Values

• count - Number of elements returned in this response
• total_count - Total number of matching elements
• calendars - Object containing list of all returned matching appointments
  • id - Event unique ID
  • name - User friendly name

Example Response

Returns a json object with the following makeup.

{
  "events": [
    {
      "id": "30min",
      "name": "30 minute appointment",
      "links": [
        {
          "rel": "self",
          "href": "/api/v1/event/30min",
          "verbs": [
            "GET",
            "DELETE"
          ]
        }
      ]
    },
    <...snip...>
  ],
  "count": 3,
  "total_count": 3,
  "links": [
    {
      "rel": "self",
      "href": "/api/v1/event",
      "verbs": [
        "GET"
      ]
    }
  ]
}

Examples

curl

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

python

>>> import requests

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