{
  "url": "https://telipot.com/catalog/tasks/google-calendar.events.get",
  "id": "google-calendar.events.get",
  "name": "One event on a calendar by its id, with attendees and times",
  "provider": {
    "slug": "google-calendar",
    "name": "Google Calendar"
  },
  "capability": "calendar.events.get",
  "platform": "calendar",
  "kind": "data",
  "tier": "core",
  "identity": "user",
  "identityLabel": "Person’s own",
  "price": {
    "amount": "Free",
    "state": "free",
    "label": "Free",
    "detail": "Free from the tool",
    "type": "free"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "free",
  "live": true,
  "summary": "Returns an event based on its Google Calendar ID. To retrieve an event using its iCalendar ID, call the events.list method using the iCalUID parameter.",
  "method": "GET",
  "path": "/calendar/v3/calendars/{calendarId}/events/{eventId}",
  "host": "https://www.googleapis.com",
  "docsUrl": "https://developers.google.com/workspace/calendar/api/v3/reference/events/get",
  "auth": {
    "scheme": "oauth",
    "label": "oauth · OAuth 2.0 with PKCE",
    "short": "oauth · OAuth 2.0"
  },
  "scope": "own_account",
  "principal": "user",
  "requiredScopes": [
    "calendar.readonly"
  ],
  "verification": {
    "state": "none",
    "label": "Not verified yet",
    "detail": "Not checked yet. We test with a real request before we mark it."
  },
  "input": [
    {
      "name": "calendarId",
      "location": "pathParams",
      "type": "string",
      "required": true,
      "constraints": [],
      "note": "primary for the connected account's own calendar, or an id from google-calendar.calendars.list"
    },
    {
      "name": "eventId",
      "location": "pathParams",
      "type": "string",
      "required": true,
      "constraints": [],
      "note": "The event id, as google-calendar.events.list returns it"
    },
    {
      "name": "timeZone",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "The time zone of the times in the answer; the calendar's own when absent"
    },
    {
      "name": "maxAttendees",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "at least 1"
      ],
      "note": "The most attendees to return; the answer marks any it left out with attendeesOmitted"
    }
  ],
  "sampleInput": {
    "calendarId": "primary",
    "eventId": "3vq8k2nd5ho1c7a9f0b4lmetoe"
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "calendarId": {
        "type": "string",
        "description": "primary for the connected account's own calendar, or an id from google-calendar.calendars.list",
        "examples": [
          "primary"
        ]
      },
      "eventId": {
        "type": "string",
        "description": "The event id, as google-calendar.events.list returns it",
        "examples": [
          "3vq8k2nd5ho1c7a9f0b4lmetoe"
        ]
      },
      "timeZone": {
        "type": "string",
        "description": "The time zone of the times in the answer; the calendar's own when absent",
        "examples": [
          "America/Los_Angeles"
        ]
      },
      "maxAttendees": {
        "type": "integer",
        "description": "The most attendees to return; the answer marks any it left out with attendeesOmitted",
        "minimum": 1
      }
    },
    "required": [
      "calendarId",
      "eventId"
    ],
    "additionalProperties": false
  },
  "output": [
    {
      "name": "id",
      "type": "string"
    },
    {
      "name": "status",
      "type": "string",
      "description": "confirmed, tentative or cancelled"
    },
    {
      "name": "summary",
      "type": "string",
      "description": "The title"
    },
    {
      "name": "description",
      "type": "string",
      "description": "The description; it can hold HTML"
    },
    {
      "name": "location",
      "type": "string"
    },
    {
      "name": "htmlLink",
      "type": "string",
      "description": "A link to the event in the Google Calendar web app"
    },
    {
      "name": "created",
      "type": "string",
      "description": "RFC 3339 time"
    },
    {
      "name": "updated",
      "type": "string",
      "description": "RFC 3339 time of the last change to the main event data"
    },
    {
      "name": "creator",
      "type": "object"
    },
    {
      "name": "organizer",
      "type": "object"
    },
    {
      "name": "start",
      "type": "object",
      "description": "A date for an all-day event, or a dateTime with its offset"
    },
    {
      "name": "end",
      "type": "object",
      "description": "Exclusive; a date for an all-day event, or a dateTime with its offset"
    },
    {
      "name": "recurrence",
      "type": "string[]",
      "description": "RRULE, EXRULE, RDATE and EXDATE lines of a recurring event"
    },
    {
      "name": "recurringEventId",
      "type": "string",
      "description": "The id of the recurring event this is an instance of"
    },
    {
      "name": "originalStartTime",
      "type": "object"
    },
    {
      "name": "attendees",
      "type": "object[]"
    },
    {
      "name": "attendeesOmitted",
      "type": "boolean"
    },
    {
      "name": "hangoutLink",
      "type": "string"
    },
    {
      "name": "conferenceData",
      "type": "object",
      "description": "The conference details such as a Google Meet link"
    },
    {
      "name": "visibility",
      "type": "string",
      "description": "default, public, private or confidential"
    },
    {
      "name": "transparency",
      "type": "string",
      "description": "opaque when the event blocks time, transparent when it does not"
    },
    {
      "name": "eventType",
      "type": "string",
      "description": "default, birthday, focusTime, fromGmail, outOfOffice or workingLocation"
    },
    {
      "name": "colorId",
      "type": "string"
    },
    {
      "name": "iCalUID",
      "type": "string"
    },
    {
      "name": "sequence",
      "type": "integer"
    },
    {
      "name": "reminders",
      "type": "object"
    },
    {
      "name": "etag",
      "type": "string"
    },
    {
      "name": "kind",
      "type": "string"
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "status": {
        "type": "string",
        "description": "confirmed, tentative or cancelled"
      },
      "summary": {
        "type": "string",
        "description": "The title"
      },
      "description": {
        "type": "string",
        "description": "The description; it can hold HTML"
      },
      "location": {
        "type": "string"
      },
      "htmlLink": {
        "type": "string",
        "description": "A link to the event in the Google Calendar web app"
      },
      "created": {
        "type": "string",
        "description": "RFC 3339 time"
      },
      "updated": {
        "type": "string",
        "description": "RFC 3339 time of the last change to the main event data"
      },
      "creator": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "self": {
            "type": "boolean"
          }
        }
      },
      "organizer": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "self": {
            "type": "boolean"
          }
        }
      },
      "start": {
        "type": "object",
        "description": "A date for an all-day event, or a dateTime with its offset",
        "properties": {
          "date": {
            "type": "string"
          },
          "dateTime": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          }
        }
      },
      "end": {
        "type": "object",
        "description": "Exclusive; a date for an all-day event, or a dateTime with its offset",
        "properties": {
          "date": {
            "type": "string"
          },
          "dateTime": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          }
        }
      },
      "recurrence": {
        "type": "array",
        "description": "RRULE, EXRULE, RDATE and EXDATE lines of a recurring event",
        "items": {
          "type": "string"
        }
      },
      "recurringEventId": {
        "type": "string",
        "description": "The id of the recurring event this is an instance of"
      },
      "originalStartTime": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string"
          },
          "dateTime": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          }
        }
      },
      "attendees": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string"
            },
            "displayName": {
              "type": "string"
            },
            "responseStatus": {
              "type": "string",
              "description": "needsAction, declined, tentative or accepted"
            },
            "organizer": {
              "type": "boolean"
            },
            "self": {
              "type": "boolean"
            },
            "resource": {
              "type": "boolean"
            },
            "optional": {
              "type": "boolean"
            }
          }
        }
      },
      "attendeesOmitted": {
        "type": "boolean"
      },
      "hangoutLink": {
        "type": "string"
      },
      "conferenceData": {
        "type": "object",
        "description": "The conference details such as a Google Meet link"
      },
      "visibility": {
        "type": "string",
        "description": "default, public, private or confidential"
      },
      "transparency": {
        "type": "string",
        "description": "opaque when the event blocks time, transparent when it does not"
      },
      "eventType": {
        "type": "string",
        "description": "default, birthday, focusTime, fromGmail, outOfOffice or workingLocation"
      },
      "colorId": {
        "type": "string"
      },
      "iCalUID": {
        "type": "string"
      },
      "sequence": {
        "type": "integer"
      },
      "reminders": {
        "type": "object",
        "properties": {
          "useDefault": {
            "type": "boolean"
          },
          "overrides": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "method": {
                  "type": "string"
                },
                "minutes": {
                  "type": "integer"
                }
              }
            }
          }
        }
      },
      "etag": {
        "type": "string"
      },
      "kind": {
        "type": "string"
      }
    }
  },
  "example": {
    "file": "examples/google-calendar.events.get.json",
    "json": {
      "kind": "calendar#event",
      "etag": "\"EXAMPLEETAG\"",
      "id": "3vq8k2nd5ho1c7a9f0b4lmetoe",
      "status": "confirmed",
      "htmlLink": "https://www.google.com/calendar/event?eid=EXAMPLE",
      "created": "2026-09-28T16:02:10.000Z",
      "updated": "2026-09-28T16:02:10.512Z",
      "summary": "Planning",
      "creator": {
        "email": "contact@example.com",
        "self": true
      },
      "organizer": {
        "email": "contact@example.com",
        "self": true
      },
      "start": {
        "dateTime": "2026-10-12T10:00:00-07:00",
        "timeZone": "America/Los_Angeles"
      },
      "end": {
        "dateTime": "2026-10-12T10:30:00-07:00",
        "timeZone": "America/Los_Angeles"
      },
      "sequence": 0,
      "attendees": [
        {
          "email": "contact@example.com",
          "organizer": true,
          "self": true,
          "responseStatus": "accepted"
        },
        {
          "email": "guest@example.com",
          "responseStatus": "needsAction"
        }
      ],
      "reminders": {
        "useDefault": true
      },
      "eventType": "default"
    }
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run google-calendar.events.get \\\n  --input-json '{\"calendarId\":\"primary\",\"eventId\":\"3vq8k2nd5ho1c7a9f0b4lmetoe\"}' \\\n  --as user:ana",
    "http": "curl https://api.telipot.com/v1/tasks/google-calendar.events.get/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Telipot-Principal: user:ana\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"calendarId\":\"primary\",\"eventId\":\"3vq8k2nd5ho1c7a9f0b4lmetoe\"}'",
    "quote": "telipot run google-calendar.events.get \\\n  --input-json '{\"calendarId\":\"primary\",\"eventId\":\"3vq8k2nd5ho1c7a9f0b4lmetoe\"}' \\\n  --as user:ana \\\n  --quote"
  },
  "siblings": []
}