# Get Received Care Team Invitations

Get list of received invitations for logged in user. These are invitations that have been sent to this user but not yet acted upon.

Endpoint: GET /confirm/invitations/{userId}
Version: 1.0
Security: sessionToken

## Path parameters:

  - `userId` (string, required)
    Tidepool User ID

## Response 200 fields (application/json):

  - `key` (string, required)
    Example: "Sds2PHMALZrmt++JyD5mIjLkZruJldiM"

  - `type` (string, required)
    Enum: "password_reset", "careteam_invitation", "clinician_invitation", "signup_confirmation", "no_account"

  - `status` (string, required)
    Enum: "pending", "completed", "canceled", "declined"

  - `email` (string, required)
    An email address, as specified by [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322).
    Example: "example@tidepool.org"

  - `creatorId` (string, required)
    String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit [UUID v4](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))

  - `created` (string, required)
    [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) / [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) timestamp _with_ timezone information
    Example: "2017-02-06T02:37:46Z"

  - `modified` (string)
    [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) / [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) timestamp _with_ timezone information
    Example: "2017-02-06T02:37:46Z"

  - `creator` (object)

  - `creator.userid` (string, required)
    String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit [UUID v4](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))

  - `creator.profile` (object, required)

  - `creator.profile.fullName` (string, required)

  - `creator.profile.patient` (object, required)

  - `creator.profile.patient.birthday` (string)
    Example: "2012-08-30"

  - `creator.profile.patient.diagnosisDate` (string)
    Example: "2013-05-09"

  - `creator.profile.patient.isOtherPerson` (boolean)

  - `context` (string)

  - `restrictions` (object)

  - `restrictions.canAccept` (boolean, required)
    Whether the invite can be accepted by the current user

  - `restrictions.requiredIdp` (string)
    Set if the user must be authenticated against a specific identity provider before they are able to accept the invite

  - `expiresAt` (string)
    If specified, the invitation will expire at the given date and time.
    Example: "2024-01-30T08:11:00Z"

## Response 400 fields (application/json):

  - `code` (integer, required)

  - `error` (integer)

  - `reason` (string, required)

## Response 401 fields (application/json):

  - `code` (integer, required)

  - `error` (integer)

  - `reason` (string, required)