Method: userProfiles.guardianInvitations.get

Returns a specific guardian invitation.

This method returns the following error codes:

  • PERMISSION_DENIED if the requesting user is not permitted to view guardian invitations for the student identified by the studentId, if guardians are not enabled for the domain in question, or for other access errors.
  • INVALID_ARGUMENT if a studentId is specified, but its format cannot be recognized (it is not an email address, nor a studentId from the API, nor the literal string me).
  • NOT_FOUND if Classroom cannot find any record of the given student or invitationId. May also be returned if the student exists, but the requesting user does not have access to see that student.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The ID of the student whose guardian invitation is being requested.



The id field of the GuardianInvitation being requested.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of GuardianInvitation.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authorization guide.