Skip to content

Latest commit

 

History

History
98 lines (80 loc) · 2.67 KB

GET_users_show.md

File metadata and controls

98 lines (80 loc) · 2.67 KB
Raw

User Resources

GET users/show

Description

Returns the profile information for a specified user.

Requires authentication

  • A valid Consumer Key must be provided in consumer_key parameter.
  • Alternatively, a valid OAuth request with an authorized Access Token will be accepted.

Parameters

(required) One of the unique user identifiers:

  • id — Return information for the specified user ID.
  • username — Return information for the user with the specified username.
  • email — Return information for the user with the specified email address.

Return format

User profile information in full format.

Additional data:

  • following — (OAuth only) whether the currently authenticated user is following the user specified by the identifier, boolean.

Errors

All known errors cause the resource to return HTTP error code header together with a JSON array containing at least 'status' and 'error' keys describing the source of error. Some results also include 'lookup_method' key specifying the parameter that was used for user lookup.

  • 400 Bad Request — Request did not contain one of the required parameters.
  • 403 Forbidden — The user requested has been disabled.
  • 404 Not Found — User does not exist in our database.

Example

Request (Using OAuth)

GET v1/users/show?username=freeatnet

Return

{
  "user": {
    "id": 3798,
    "username": "freeatnet",
    "firstname": "Arseniy",
    "lastname": "Ivanov",
    "birthday": null,
    "sex": 1,
    "city": "Toronto",
    "state": "Ontario",
    "country": "Canada",
    "registration_date": "2009-12-15T09:40:45-05:00",
    "about": "Your local web-developer guy. Casual photographer.",
    "domain": "freeatnet.500px.com",
    "fotomoto_on": true,
    "locale": "en",
    "show_nude": true,
    "fullname": "Arseniy Ivanov",
    "userpic_url": "/graphics/userpic.png",
    "upgrade_status": 2,
    "store_on": true,
    "contacts": {
      "website": "freeatnet.com",
      "twitter": "freeatnet_en",
      "facebookpage": "www.facebook.com/av.ivanov",
      "flickr": "freeatnet",
      "facebook": "769184274"
    },
    "equipment": {
      "camera": [
        "FUJIFILM FinePix S1000",
        "Canon EOS 50"
      ],
      "misc": [
        "Google Nexus S",
        "Apple Macbook Pro 15\""
      ]
    },
    "photos_count": 12,
    "galleries_count": 5,
    "affection": 20,
    "friends_count": 57,
    "followers_count": 77,
    "following": false
  }
}