trash nothing
  1. users
trash nothing
  • messages
    • List conversations
      GET
    • Mark all conversations as read
      PUT
    • Search conversations
      GET
    • Delete conversation
      DELETE
    • Archive conversation
      PUT
    • Block conversation
      PUT
    • Mark conversation as read
      PUT
    • List conversation messages
      GET
    • Reply to conversation
      POST
    • Report conversation
      POST
    • Unarchive conversation
      PUT
    • Unblock conversation
      PUT
  • misc
    • Send feedback
  • groups
    • Search groups
    • Retrieve multiple groups
    • Join groups
    • Retrieve a group
    • Submit group answers
    • Contact group moderators
    • Leave a group
  • photos
    • Create a photo
    • Retrieve multiple photos
    • Delete a photo
    • Rotate a photo
  • posts
    • List posts
    • Submit a post
    • List all posts
    • List all post changes
    • Retrieve client.js
    • Retrieve multiple posts
    • Search posts
    • Retrieve a post
    • Update a post
    • Delete a post bookmark
    • Bookmark a post
    • Retrieve post display data
    • Flag a post
    • Map a post
    • Promise an offer post
    • Reply to a post
    • Satisfy a post
    • Share a post
    • Unpromise an offer post
    • Withdraw a post
  • stories
    • List stories
    • Submit a story
    • Retrieve a story
    • Like a story
    • Unlike a story
    • Record story viewed
  • users
    • Retrieve current user
      GET
    • Update current user
      PUT
    • List current users' email alerts
      GET
    • Create an email alert
      PUT
    • Delete an email alert
      DELETE
    • Change email address
      POST
    • Set users' email address as not bouncing
      PUT
    • List current users' groups
      GET
    • Update location
      PUT
    • List current users' group notices
      GET
    • List current users' post locations
      GET
    • Save a post location for the current user
      PUT
    • List current users' posts
      GET
    • Search current users' posts
      GET
    • Set a profile image
      POST
    • List current users' profile images
      GET
    • Resend account verification email
      POST
    • Send password reset email
      POST
    • Report a user
      POST
    • Retrieve a user
      GET
    • Retrieve user display info
      GET
    • Submit feedback on a user
      POST
    • List posts by a user
      GET
    • Search posts by a user
      GET
    • Retrieve a users' profile image
      GET
  1. users

Retrieve a user

GET
/users/{user_id}
users
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://trashnothing.com/api/v1.2/users/'
Response Response Example
200 - Example 1
{
    "about_me": "Just an old fisherman looking to reuse more.",
    "country": "GB",
    "feedback": {
        "percent_positive": 87.5,
        "restriction": "no-recent-messages",
        "score": 7
    },
    "firstname": null,
    "lastname": null,
    "member_since": "2017-01-27T06:35:55",
    "profile_image": "https://lh3.googleusercontent.com/-1qVLzuOCyYg/AAAAAAAAAAI/AAAAAAAAAAA/0aGNzRAO61c/s64-c/100783935580725962164.jpg",
    "reply_time": 4850,
    "user_id": 2946512,
    "username": "fred gibson"
}

Request

Path Params
user_id
string 
required
A user ID.

Responses

🟢200User data
application/json
Body
about_me
string 
optional
A short bio a user has written about themselves to help other members get to know them better. May be null if the user has not written anything about themselves.
country
string 
optional
A 2 letter country code for the country that has been automatically detected for the user (see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ). May be null if no country has been set.
feedback
object 
optional
percent_positive
number 
optional
The percent of feedback that this user has received in the last year that was positive. May be null if a user has not received enough feedback to calculate a percentage.
>= 0<= 100
restriction
string 
optional
If the current user can leave positive or negative feedback on this user then restriction is null.

Otherwise, restriction is set to a string that explains why feedback is currently restricted and what type of feedback is restricted. The string will be one of the following: no-recent-messages, negative-score, moderator, [days]-day-wait-for-negative

- no-recent-messages: The current user has not received any messages from this user in the last 30 days.
- negative-score: The current user has a negative feedback and will not be able to leave feedback until their score is >= 0.
- moderator: The user is a moderator and leaving feedback on moderators is not currently supported.
- [days]-day-wait-for-negative: Positive feedback is not restricted but the current user must wait
some number of days before they will be able to leave negative feedback on this user. This string can
change depending on the number of days. For example, when the current user must wait one day, the
string will be '1-day-wait-for-negative'. A wait is necessary because a lot of negative feedback results
from communication issues that are resolved with more time.
score
integer 
optional
The feedback score of this user. Higher scores are better. Scores are calculated by substracting the total number of negative feedback from the total number of positive feedback that a user has received. May be null if a user has not received enough feedback to calculate a score.
firstname
string 
optional
The first name of the user (may be null).
lastname
string 
optional
The last name of the user (may be null).
member_since
string 
optional
The date and time when the user first became publicly active on a group (the date may be older than when the user signed up).
profile_image
string 
optional
A URL to a profile image for the user. Profile images sizes vary based on the source (Google, Facebook, Gravatar, etc) and some can be as small as 64px by 64px. Will be null for api key requests and requests where the oauth user doesn't belong to any of the same groups as this user.
reply_time
integer 
optional
An estimate of how many seconds it takes this user to reply to messages. May be null when there is not enough data to calculate an estimate.
user_id
string 
optional
username
string 
optional
A username that can be displayed for the user (the username is NOT guaranteed to be unique). Will be null for api key requests and requests where the oauth user doesn't belong to any of the same groups as this user.
🟠404User not found.
Modified at 2022-09-11 18:59:48
Previous
Report a user
Next
Retrieve user display info
Built with