GET login/users/:user id

Description

Returns user information, including his profile (if required).

Resource URL

  GET https://api.socialidnow.com/v1/marketing/login/users/:user_id

Parameters

URL Parameters

user_id	required	user identifier.
fields	optional	a list of user profile field names to be returned, joined by commas. See Social Profile Fields.

Authentication

This API requires Account authentication. See Authentication.

Response

Response Body

The following fields are returned:

id	user identifier in the Social Login.
profile	a hash with the fields request by the parameter "fields". This field will only be present if at least one field is requested.
signed_in_at	date of user latest login.
signed_up_at	date of user creation.
token	user token. This token is used as user identifier in some Javascript APIs. See Social Login Tokens for more details.
username	username. Set by POST login/users and PUT login/users/:user_id apis.
email_address	email_address. Set by POST login/users and PUT login/users/:user_id apis.
active	boolean flag to inform whether the user is activated for login. Set by PUT login/users/:user_id/activate and PUT login/users/:user_id/deactivate apis.
confirmed	boolean flag to inform whether the user has confirmed his email address. See POST login/users/send_email_confirmation for instructions on how to add email address confirmation.
locked	boolean flag to inform whether the user is locked due to too many login attempts with an incorrect password. See Login App Security Settings and PUT login/users/:user_id/unlock.

Examples

Without fields

Request

Returns information for user "340":

 curl -X GET 'https://api.socialidnow.com/v1/marketing/login/users/340' \
        --user <api_id>:<api_secret>

Response

Response Body

{
     "id": 340,
     "signed_in_at": "2013-08-08T03:32:40Z",
     "signed_up_at": "2012-10-04T14:34:10Z",
     "token": "12345678901234567890123456789012",
     "username": "john_doe",
     "email_address": "john_doe@domain.com",
     "active": true,
     "confirmed": true,
     "locked": false
}

With fields

Request

Returns information for user "340" with profile fields display_name, verified_email and current_location:

 curl -X GET 'https://api.socialidnow.com/v1/marketing/login/users/340?fields=display_name,verified_email,current_location' \
        --user <api_id>:<api_secret>

Response

Response Body

{
     "id": 340,
     "profile": {
         "current_location": "Campinas, SP, Brasil",
         "display_name": "John Doe",
         "verified_email": "john.doe@somedomain.com"
     },
     "signed_in_at": "2013-08-08T03:32:40Z",
     "signed_up_at": "2012-10-04T14:34:10Z",
     "token": "12345678901234567890123456789012",
     "username": "john_doe",
     "email_address": "john_doe@domain.com",
     "active": true,
     "confirmed": true,
     "locked": false
}