Skip to main content

users

Overview

Nameusers
TypeResource
Idgithub.users.users

Fields

NameDatatype
idinteger
namestring
planobject
suspended_atstring
public-user_private_gistsinteger
public-user_owned_private_reposinteger
emailstring
public-user_planobject
organizations_urlstring
twitter_usernamestring
public-user_twitter_usernamestring
public-user_urlstring
public-user_companystring
urlstring
private_gistsinteger
public-user_received_events_urlstring
public-user_followersinteger
starred_urlstring
public-user_html_urlstring
disk_usageinteger
public-user_blogstring
locationstring
public-user_updated_atstring
ldap_dnstring
hireableboolean
public-user_hireableboolean
owned_private_reposinteger
updated_atstring
public-user_starred_urlstring
public-user_idinteger
public-user_repos_urlstring
public-user_total_private_reposinteger
public-user_disk_usageinteger
public-user_followinginteger
collaboratorsinteger
public-user_typestring
public-user_organizations_urlstring
public-user_followers_urlstring
biostring
gravatar_idstring
public-user_public_reposinteger
public-user_events_urlstring
public-user_collaboratorsinteger
events_urlstring
public_gistsinteger
created_atstring
public-user_following_urlstring
subscriptions_urlstring
public-user_loginstring
public-user_created_atstring
loginstring
avatar_urlstring
gists_urlstring
public-user_emailstring
typestring
public-user_namestring
node_idstring
received_events_urlstring
followinginteger
followers_urlstring
companystring
repos_urlstring
followersinteger
following_urlstring
business_plusboolean
public_reposinteger
public-user_site_adminboolean
public-user_gists_urlstring
site_adminboolean
public-user_node_idstring
html_urlstring
public-user_subscriptions_urlstring
two_factor_authenticationboolean
total_private_reposinteger
public-user_avatar_urlstring
public-user_suspended_atstring
blogstring
public-user_locationstring
public-user_public_gistsinteger
public-user_biostring
public-user_gravatar_idstring

Methods

NameAccessible byRequired ParamsDescription
get_by_usernameSELECTusernameProvides publicly available information about someone with a GitHub account.

GitHub Apps with the Plan user permission can use this endpoint to retrieve information about a user's GitHub plan. The GitHub App must be authenticated as a user. See "Identifying and authorizing users for GitHub Apps" for details about authentication. For an example response, see 'Response with GitHub plan information' below"

The email key in the following response is the publicly visible email address from your GitHub profile page. When setting up your profile, you can select a primary email address to be “public” which provides an email entry for this endpoint. If you do not set a public email address for email, then it will have a value of null. You only see publicly visible email addresses when authenticated with GitHub. For more information, see Authentication.

The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see "Emails API".
listSELECTLists all users, in the order that they signed up on GitHub. This list includes personal user accounts and organization accounts.

Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of users.
get_authenticatedEXECIf the authenticated user is authenticated through basic authentication or OAuth with the user scope, then the response lists public and private profile information.

If the authenticated user is authenticated through OAuth without the user scope, then the response lists only public profile information.
update_authenticatedEXECNote: If your email is set to private and you send an email parameter as part of this request to update your profile, your privacy settings are still enforced: the email address will not be displayed on your public profile or via the API.