Get User Details

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement.

API Version

200

Object
Successful response containing information about the current user.

Meta

Object
Metadata object for successful response from the 'get self user' endpoint.

• code (integer) - Status code indicating the result of the API request.
• requestId (string) - Unique identifier for the API request.

Notifications

Array of objects
Array of notification objects for the current user.

• item (object)
  • type (string) - Type of notification for the current user.
  • unreadCount (integer) - Number of unread notifications.

Response

Object
Response object containing retrieved data for the user's self profile.

• user (object)
  • Includes user profile data.

Example cURL Request

curl --request GET \
     --url https://api.foursquare.com/v2/users/self \
     --header 'accept: application/json'

Example Response

{
  "meta": {
    "code": 200,
    "requestId": "652465929317ed6e8eb7be9b"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    },
    {
      "type": "unconfirmed",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "user": {
      "id": "123456",
      "firstName": "John",
      "lastName": "Smith",
      "handle": "johnsmith",
      "privateProfile": false,
      "gender": "male",
      "countryCode": "US",
      "photo": {
        "prefix": "https://fastly.4sqi.net/img/user/",
        "suffix": "/blank_boy.png"
      },
      "friends": {
        "count": 5,
        "groups": [
          {
            "type": "others",
            "name": "Other friends",
            "count": 5,
            "items": []
          }
        ]
      },
      "tips": {
        "count": 19
      },
      "photos": {
        "count": 14,
        "items": []
      },
      "checkins": {
        "count": 23,
        "items": []
      },
      "lists": {
        "count": 15,
        "groups": []
      },
      "createdAt": 1299013789
    }
  }
}