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 user display info

GET
/users/{user_id}/display
users
Retrieve a user and information related to the user (eg. recent posts) that is useful for displaying a more detailed view of the user.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://trashnothing.com/api/v1.2/users//display'
Response Response Example
200 - Example 1
{
    "feedback": [
        {
            "content": "Fred gave me a great antique table for my new apartment!",
            "date": "2020-03-01T12:01:22",
            "positive": true,
            "reviewer_user_id": 9191,
            "user_id": 2946512
        }
    ],
    "offer_count": 0,
    "posts": [
        {
            "content": "This ultrasonic diffuser creates an aroma in your home. It comes with two essential oils - mint and lavender.",
            "date": "2018-02-05T15:10:21",
            "footer": null,
            "group_id": 6,
            "latitude": 43.653226,
            "longitude": -79.383184,
            "outcome": "satisfied",
            "photos": [
                {
                    "images": [
                        {
                            "height": 120,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.90x120.jpg",
                            "width": 90
                        },
                        {
                            "height": 240,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.180x240.jpg",
                            "width": 180
                        },
                        {
                            "height": 360,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.270x360.jpg",
                            "width": 270
                        },
                        {
                            "height": 500,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.375x500.jpg",
                            "width": 375
                        }
                    ],
                    "photo_id": "695624-768616",
                    "thumbnail": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.90x120.jpg",
                    "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.375x500.jpg"
                }
            ],
            "post_id": 3171898,
            "title": "Ultrasonic diffuser (Downtown Toronto)",
            "type": "offer",
            "user_id": 2933
        }
    ],
    "user": {
        "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"
    },
    "wanted_count": 0
}

Request

Path Params
user_id
string 
required
A user ID.

Responses

🟢200The user and related data.
application/json
Body
feedback
array[object (Feedback) {5}] 
optional
Feedback the current user has left on the user.
content
string 
optional
A comment written by the reviewer about the user (may be null).
date
string <date-time>
optional
Date when the feedback was submitted.
positive
boolean 
optional
Set to true for positive feedback and false for negative feedback.
reviewer_user_id
string 
optional
The user ID of the user that submitted the feedback.
user_id
string 
optional
The user ID of the user that the feedback is about.
offer_count
integer 
optional
Count of offer posts made by the user in the last 90 days.
posts
array[object (Post) {15}] 
optional
Other active posts from the user in the last 90 days. A maximum of 30 posts will be returned.
content
string 
optional
date
string <date-time>
optional
The UTC date and time when the post was published.
expiration
string <date-time>
optional
The UTC date and time when the post will expire. Currently only offer and wanted posts expire. For all other posts, expiration is always null.
footer
string 
optional
Some groups add footers to posts that are separate and sometimes unrelated to the post itself - such as reminders about group rules or features (may be null).
group_id
string 
optional
The group ID of the post. For public posts, this is always null.
latitude
number 
optional
May be null if a post hasn't been mapped.
longitude
number 
optional
May be null if a post hasn't been mapped.
outcome
string 
optional
For offer and wanted posts, this indicates the outcome of the post which is null if no outcome has been set yet.

Offer post outcomes will be one of: satisfied, withdrawn, promised, expired

Wanted post outcomes will be one of: satisfied, withdrawn, expired

For all other posts, outcome is always null.
photos
array[object (Photo) {5}] 
optional
Details about the photos associated with this post (may be null if there are no photos).
post_id
string 
optional
source
string 
optional
The source of the post. One of: groups, trashnothing, open_archive_groups. A value of groups or open_archive_groups indicates the post is from a group and the group_id field will contain the ID of the group. A value of trashnothing indicates the post is a public post not associated with any group.
title
string 
optional
type
string 
optional
The type of post. One of: offer, taken, wanted, received, admin
url
string 
optional
The link to use to view the post on the trash nothing site.
user_id
string 
optional
user
object (User) 
optional
Example:
{"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"}
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
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.
wanted_count
integer 
optional
Count of wanted posts made by the user in the last 90 days.
🟠404User not found.
Modified at 2022-09-11 18:59:48
Previous
Retrieve a user
Next
Submit feedback on a user
Built with