Note: New consumer accounts with the customer's verified domain created within the previous 48 hours will not appear in the result. This delay also applies to newly-verified domains.
HTTP request
GET https://cloudidentity.googleapis.com/v1/{parent=customers/*}/userinvitations
Required. The customer ID of the Google Workspace or Cloud Identity account the UserInvitation resources are associated with.
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of UserInvitation resources to return. If unspecified, at most 100 resources will be returned. The maximum value is 200; values above 200 will be set to 200.
pageToken
string
Optional. A page token, received from a previous userinvitations.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to ListBooks must match the call that provided the page token.
filter
string
Optional. A query string for filtering UserInvitation results by their current state, in the format: "state=='invited'".
orderBy
string
Optional. The sort order of the list results.
You can sort the results in descending order based on either email or last update timestamp but not both, using order_by="email desc". Currently, sorting is supported for update_time asc, update_time desc, email asc, and email desc.
If not specified, results will be returned based on email asc order.
The token for the next page. If not empty, indicates that there may be more UserInvitation resources that match the listing request; this value can be used in a subsequent ListUserInvitationsRequest to get continued results with the current list call.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eThis API endpoint retrieves a list of \u003ccode\u003eUserInvitation\u003c/code\u003e resources associated with a specific Google Workspace or Cloud Identity account, identified by the customer ID.\u003c/p\u003e\n"],["\u003cp\u003eNew consumer accounts or newly-verified domains created within the past 48 hours will not be included in the results returned by this API.\u003c/p\u003e\n"],["\u003cp\u003eThe number of \u003ccode\u003eUserInvitation\u003c/code\u003e resources returned can be controlled using the \u003ccode\u003epageSize\u003c/code\u003e parameter, with a maximum of 200, and the results can be navigated using the \u003ccode\u003epageToken\u003c/code\u003e for pagination.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter the results by their current state, for example, to only display invited users, and you can sort the results by email or last update timestamp, in ascending or descending order.\u003c/p\u003e\n"],["\u003cp\u003eAccess to this API requires specific OAuth scopes, either \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.userinvitations.readonly\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.userinvitations\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]