> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one CoworkerGoogleCalendar

> Retrieve a single CoworkerGoogleCalendar record by its Id.

A **CoworkerGoogleCalendar** record represents a Google Calendar account connected to a customer's Nexudus account.

These records are created automatically when a customer connects their own Google Calendar from the Members Portal or the Nexudus app. Once connected, customers can book resources at a location directly from their Google Calendar.

Each record stores the Google push-notification subscription details (`SubscriptionId`, `WatchResourceId`, `SubscriptionExpireDate`) used to keep the calendar in sync, as well as an `EventSyncToken` for incremental Google Calendar API event queries.

For more information, see the [Google Calendar (Customer)](https://help.nexudus.com/docs/google-calendar-customer) help article.

## Authentication

<Note>
  This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
  The authenticated user must be a full unrestricted administrator or have the **`CoworkerGoogleCalendar-Read`** role.
</Note>

## Path Parameters

<ParamField path="id" type="integer" required>
  The Id of the CoworkerGoogleCalendar record to retrieve.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    "https://spaces.nexudus.com/api/spaces/coworkergooglecalendars/87654321" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://spaces.nexudus.com/api/spaces/coworkergooglecalendars/87654321',
    {
      headers: {
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    }
  );

  const record = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://spaces.nexudus.com/api/spaces/coworkergooglecalendars/87654321',
      headers={
          'Authorization': 'Bearer YOUR_TOKEN'
      }
  )

  record = response.json()
  ```
</CodeGroup>

## Response

### 200

<ResponseField name="ResourceId" type="integer">
  ID of the Nexudus resource (room or desk) used as the Google Calendar push-notification watch target for this connection.
</ResponseField>

<ResponseField name="CoworkerId" type="integer">
  ID of the customer who connected their Google Calendar.
</ResponseField>

<ResponseField name="CoworkerFullName" type="string">
  Full name of the customer who connected their Google Calendar.
</ResponseField>

<ResponseField name="Name" type="string">
  Display name of the connected Google Calendar.
</ResponseField>

<ResponseField name="SubscriptionId" type="string">
  Google push-notification channel ID used to receive calendar change notifications.
</ResponseField>

<ResponseField name="CalendarId" type="string">
  Google Calendar ID of the customer's connected calendar (e.g. [user@gmail.com](mailto:user@gmail.com) or a secondary calendar ID).
</ResponseField>

<ResponseField name="SubscriptionExpireDate" type="string">
  Date and time when the Google push-notification channel subscription expires and must be renewed.
</ResponseField>

<ResponseField name="WatchResourceId" type="string">
  Google-assigned resource ID for the active push-notification watch channel.
</ResponseField>

<ResponseField name="EventSyncToken" type="string">
  Incremental sync token returned by the Google Calendar API, used to fetch only events changed since the last sync.
</ResponseField>

<ResponseField name="Id" type="integer">
  Unique record identifier.
</ResponseField>

<ResponseField name="UniqueId" type="string">
  UUID of the record.
</ResponseField>

<ResponseField name="CreatedOn" type="string">
  Date and time the record was created (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedOn" type="string">
  Date and time the record was last updated (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedBy" type="string">
  Email of the user who last updated this record.
</ResponseField>

<ResponseField name="IsNew" type="boolean">
  Whether the record was recently created.
</ResponseField>

<ResponseField name="SystemId" type="string">
  External system identifier.
</ResponseField>

```json Example Response theme={null}
{
  "ResourceId": 0,
  "CoworkerId": null,
  "CoworkerFullName": null,
  "Name": "",
  "SubscriptionId": "",
  "CalendarId": "",
  "SubscriptionExpireDate": "2025-01-15T10:30:00Z",
  "WatchResourceId": "",
  "EventSyncToken": null,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "CoworkerGoogleCalendar Example",
  "LocalizationDetails": null,
  "CustomFields": null
}
```
