List Labels

GET {{baseUrl}}/gmail/v1/users/:userId/labels

Lists all labels in the user's mailbox.

Request Params

KeyDatatypeRequiredDescription
access_tokenstringOAuth access token.
altstringData format for response.
callbackstringJSONP
fieldsstringSelector specifying which fields to include in a partial response.
keystringAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
oauth_tokenstringOAuth 2.0 token for the current user.
prettyPrintstringReturns response with indentations and line breaks.
quotaUserstringAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
upload_protocolstringUpload protocol for media (e.g. "raw", "multipart").
uploadTypestringLegacy upload protocol for media (e.g. "media", "multipart").
$.xgafvstringV1 error format.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"labels":[{"id":"mollit enim dolore reprehenderit","name":"non consequat","messageListVisibility":"show","labelListVisibility":"labelShow","type":"user","messagesTotal":-89757017,"messagesUnread":37713675,"threadsTotal":-34499465,"threadsUnread":38690910,"color":{"textColor":"ut minim Excepteur Ut","backgroundColor":"dolor id fugiat consectetur"}},{"id":"ut incididunt anim esse dolore","name":"magna voluptate in aliquip et","messageListVisibility":"hide","labelListVisibility":"labelShow","type":"user","messagesTotal":-45069202,"messagesUnread":-69687222,"threadsTotal":-63655159,"threadsUnread":-93904503,"color":{"textColor":"irure t","backgroundColor":"occaecat aliquip"}}]}