GET user/…/email-addresses

GET Retrieves the details of the email addresses linked to a user account.

Users are always permitted to retrieve the details of their own user account. Retrieving the details of another user account is only permitted if the calling user is a member of the same organization as the requested user.

Resource URL

https://www.drillster.com/api/2/user/self/email-addresses

or

https://www.drillster.com/api/2/user/{user_id}/email-addresses

Response

A 2.0 UserEmailAddresses object with the details of the email addresses stored for the requested user account.

Parameters

Field	Description
user_id required	The user ID of the user to retrieve details for. To retrieve the details of the own user account, the value self may be used as well. Example value: 7OuHq-RcQO_snGWR58TnBw

Example request

GET https://www.drillster.com/api/2/user/self/email-addresses

Response

{
  "total" : 1,
  "userEmailAddresses" : [ {
    "emailAddress" : {
      "address" : "thomas@example.com",
      "verified" : false
    },
    "primary" : true
  } ]
}

Error responses

The following error situations are possible:

ID	Response code	Description
not_authenticated	401 (Unauthorized)	User was not authenticated
invalid_user_id	400 (Bad request)	Given user ID is not valid
nonexistent_user	404 (Not found)	Requested user not found
no_access	403 (Forbidden)	Caller does not have access to requested user