---
title: "Get invitations received by the current user"
method: GET
path: "/api/v1/users/me/invitations"
tags: ["/users/me/invitations"]
---

# Get invitations received by the current user

`GET /api/v1/users/me/invitations`

## Query parameters

- `InvitationTypes` InvitationType[]
- `InvitationStatuses` InvitationStatus[]
- `SearchString` string
- `FromDateTime` string, date-time
- `ToDateTime` string, date-time
- `Page` integer
- `PageSize` integer

## Response `200`

OK

- InvitationListResponse
  - `totalItems` integer, required
  - `items` Invitation[], required
    - `id` integer, required
    - `type` 1 | 3, required — 1 = UserOrganizationJoining, 3 = SmartCardAssignment
    - `status` 1 | 2 | 3 | 4, required — 1 = Pending, 2 = Accepted, 3 = Rejected, 4 = Canceled
    - `data` InvitationData, required
      - `type` 1 | 3, required — 1 = UserOrganizationJoining, 3 = SmartCardAssignment
      - `senderDisplayName` string, required
      - `senderOrganizationName` string, nullable
    - `dateCreated` string, date-time, required
    - `dateUpdated` string, date-time, nullable
    - `receiverEmail` string, nullable
    - `receiver` User
      - `id` integer, required
      - `organizationId` integer, nullable — OBSOLETE: Returns one of the organizations that the user is member of - use OrganizationIds instead
      - `organizationIds` integer[], nullable
      - `email` string, required
      - `firstName` string, required
      - `lastName` string, required
      - `cultureCode` string, nullable
      - `imageId` integer, nullable
      - `displayName` string, required
      - `type` 1 | 2 | 3, required — 1 = Standard, 2 = Managed, 3 = Service
      - `roles` Role[], required — Only populated if a single user has been requested
        - `id` integer, required
        - `name` string, required
        - `displayName` string, required
        - `isDefaultRole` boolean, required
        - `dateCreated` string, date-time, required
        - `dateUpdated` string, date-time
      - `accessGroups` AccessGroup[], nullable — Only populated for requests to the API endpoint /organizations/{organizationId}/permissions
        - `id` integer, required
        - `name` string, required
        - `locks` union[], required
          - union
            - Lock
              - …
            - LockInfo
              - …
        - `users` User[], required
        - `permissionType` 1 | 2, required — 1 = Always, 2 = TimeProfile
        - `permissionTimeProfile` PermissionTimeProfile
          - `startDate` string, date-time, nullable — Start date in lock time zone, specified without time zone information (e.g. 2020-04-07T14:25:00), unrestricted if not set, applies only if RepetitionType != None
          - `endDate` string, date-time, nullable — End date in lock time zone, specified without time zone information (e.g. 2020-04-07T14:25:00), unrestricted if not set, applies only if RepetitionType != None
          - `repetitionType` 0 | 1, required — 0 = None, 1 = Weekly
          - `items` PermissionTimeProfileItem[], nullable — List of items, Required if RepetitionType == None
            - `startDate` string, date-time, required — Start date in lock time zone, specified without time zone information (e.g. 2020-04-07T14:25:00)
            - `endDate` string, date-time, required — End date in lock time zone, specified without time zone information (e.g. 2020-04-07T14:25:00)
            - `referenceId` string, nullable
          - `weeklyItems` PermissionTimeProfileWeeklyItem[], nullable — List of weekly items, Required if RepetitionType == Weekly
            - `dayOfWeek` integer, required — Day of week starting with Sunday (Sunday => 0, Monday => 1, Tuesday => 2, Wednesday => 3, Thursday => 4, Friday => 5, Saturday => 6)
            - `startTime` integer, required — Start time in minutes passed since midnight (local time in lock time zone) i.e. 00:00 => 0 or 10:00 => 600
            - `endTime` integer, required — End time in minutes passed since midnight (local time in lock time zone) i.e. 15:00 => 900 or 00:00 => 1440
        - `permissionOptions` PermissionOptions, required
          - `isRemoteActivationAllowed` boolean — Allow a user to open and close locks with the web app (the activation doesn't use Bluetooth)
          - `areAllActivationModesAllowed` boolean — Allow a user to open and close locks also in office mode (locks stay open or closed after activation)
          - `changedBy` string, nullable — Indicate who changed access of user
        - `organizationId` integer, required
        - `dateCreated` string, date-time, required
        - `dateUpdated` string, date-time, nullable
    - `organization` Organization, required
      - `id` integer, required
      - `name` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/kleverkey/apis/kleverkey-api.md) · [All operations](https://skmtc.net/kleverkey/apis/kleverkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kleverkey/kleverkey-api/versions/c65c361917fe/schema)