Trash Nothing

trash nothing

This is the REST API for [trashnothing.com](https://trashnothing.com). To learn more about the API or to register your app for use with the API visit the…

Social#openapi#social

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

This is the REST API for trashnothing.com.

To learn more about the API or to register your app for use with the API
visit the trash nothing Developer page.

NOTE: All date-time values are UTC
and are in ISO 8601 format (eg. 2019-02-03T01:23:53).

Endpoints 76

users

  • GETRetrieve current user/users/me
  • PUTUpdate current user/users/meUpdate the current user. All fields are optional so requests can update just one or multiple user properties at a time.
  • GETList current users' email alerts/users/me/alerts
  • PUTCreate an email alert/users/me/alerts
  • DELETEDelete an email alert/users/me/alerts/:alert_id
  • POSTChange email address/users/me/emailChange the users' current email address. A verification link will be emailed to the new email address to verify that the email account belongs to the user.…
  • PUTSet users' email address as not bouncing/users/me/email/not-bouncingResets an email address bouncing state to false. The users' email address may be automatically marked as bouncing again if further emails sent to it are…
  • GETList current users' groups/users/me/groups?membership=string
  • PUTUpdate location/users/me/locationUpdate the current users' location. The location is used to determine which posts are shown to the user (both public posts and group posts).
  • GETList current users' group notices/users/me/notices?group_ids=string
  • GETList current users' post locations/users/me/post-locationsOnly the most recent 3 post locations are returned.
  • PUTSave a post location for the current user/users/me/post-locationsCreates or updates a post location for the current user. Updates will happen when the name of the post location matches a previous post location.
  • GETList current users' posts/users/me/posts?sort_by=date&types=string&sources=string&group_ids=The group IDs of every group the current user is a member of.&per_page=20&page=1&device_pixel_ratio=1&latitude=0.0&longitude=0.0&radius=0.0&date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&outcomes=&user_state=&include_reposts=1NOTE: In order to make it easier to see all a users' posts, the current users' location preferences are not applied when listing or searching posts…
  • GETSearch current users' posts/users/me/posts/search?search=string&sort_by=relevance&types=string&sources=string&group_ids=The group IDs of every group the current user is a member of.&per_page=20&page=1&device_pixel_ratio=1&latitude=0.0&longitude=0.0&radius=0.0&date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&outcomes=&user_state=&include_reposts=1Searching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters.
  • POSTSet a profile image/users/me/profile-imageProfile images must be at least 90 pixels wide and tall. And if the image used is not square it will be automatically cropped to be square.
  • GETList current users' profile images/users/me/profile-images
  • POSTResend account verification email/users/me/resend-verification
  • POSTSend password reset email/users/me/reset-password
  • POSTReport a user/users/report
  • GETRetrieve a user/users/:user_id
  • GETRetrieve user display info/users/:user_id/displayRetrieve a user and information related to the user (eg. recent posts) that is useful for displaying a more detailed view of the user.
  • POSTSubmit feedback on a user/users/:user_id/feedbackAllows the current user to submit feedback on a user. The current user can only leave feedback on a user if the feedback allowed property on that user is set…
  • DELETERemove feedback on a user/users/:user_id/feedbackAllows the current user to remove feedback that they left on a user.
  • GETList posts by a user/users/:user_id/posts?sort_by=date&types=string&sources=string&group_ids=The group IDs of every group the current user is a member of.&per_page=20&page=1&device_pixel_ratio=1&latitude=0.0&longitude=0.0&radius=0.0&date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&outcomes=&include_reposts=1NOTE: In order to make it easier to see all a users' posts, the current users' location preferences are not applied when listing or searching posts…
  • GETSearch posts by a user/users/:user_id/posts/search?search=string&sort_by=relevance&types=string&sources=string&group_ids=The group IDs of every group the current user is a member of.&per_page=20&page=1&device_pixel_ratio=1&latitude=0.0&longitude=0.0&radius=0.0&date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&outcomes=&include_reposts=1Searching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters.
  • GETRetrieve a users' profile image/users/:user_id/profile-image?default=stringThis is designed to be used as the src attribute of an HTML <img> tag to show the profile image of the given user.

posts

  • GETList posts/posts?sort_by=date&types=string&sources=string&group_ids=The group IDs of every group the current user is a member of.&per_page=20&page=1&device_pixel_ratio=1&latitude=0.0&longitude=0.0&radius=0.0&date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&outcomes=&user_state=&include_reposts=1NOTE: When paging through the posts returned by this endpoint, there will be at most 1,000 posts that can be returned (eg. 50 pages worth of posts with the…
  • POSTSubmit a post/postsSubmits a new post.
  • GETList all posts/posts/all?types=string&date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&per_page=20&page=1&device_pixel_ratio=1This endpoint provides an easy way to get a feed of all the publicly published posts on trash nothing. It provides access to all publicly published offer and…
  • GETList all post changes/posts/all/changes?date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&per_page=20&page=1This endpoint provides an easy way to get a feed of all the changes that have been made to publicly published posts on trash nothing. Similar to the…
  • GETRetrieve multiple posts/posts/multiple?post_ids=string
  • GETSearch posts/posts/search?search=string&sort_by=relevance&types=string&sources=string&group_ids=The group IDs of every group the current user is a member of.&per_page=20&page=1&device_pixel_ratio=1&latitude=0.0&longitude=0.0&radius=0.0&date_min=2024-01-01T00:00:00Z&date_max=2024-01-01T00:00:00Z&outcomes=&user_state=&include_reposts=1Searching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters. NOTE: When paging through the posts…
  • GETRetrieve a post/posts/:post_id
  • PUTUpdate a post/posts/:post_idUsers can update posts to fix mistakes with their post, add photos, or add more details about the items. Updates should not be used to say that items in a…
  • DELETEDelete a post/posts/:post_idUsers can delete posts they have made that have been satisfied or withdrawn or that have expired. Deleting posts isn't intended to be a normal part of the…
  • PUTBookmark a post/posts/:post_id/bookmark
  • DELETEDelete a post bookmark/posts/:post_id/bookmark
  • GETRetrieve post display data/posts/:post_id/displayRetrieve a post and other data related to the post that is useful for displaying the post such as data about the user who posted the post and the groups the…
  • PUTPromise an offer post/posts/:post_id/promiseMark an offer by the current user as promised to someone. This helps people viewing the post know that the items being offered may soon be given away as long…
  • POSTReply to a post/posts/:post_id/replySend a reply to a post from the current user to the post author.
  • POSTReport a post/posts/:post_id/reportReports a post to be reviewed by the moderators.
  • PUTSatisfy a post/posts/:post_id/satisfyMark an offer or wanted post by the current user as satisfied (eg. an offer has been taken or a wanted has been received).
  • POSTShare a post/posts/:post_id/shareForwards a copy of the post to the current user so that they can forward it to friends.
  • PUTUnpromise an offer post/posts/:post_id/unpromiseMark an offer by the current user as unpromised.
  • PUTWithdraw a post/posts/:post_id/withdrawMark an offer or wanted post by the current user as withdrawn.

groups

  • GETSearch groups/groups?name=string&latitude=0.0&longitude=0.0&distance=100&country=string&region=string&postal_code=string&page=1&per_page=20
  • GETRetrieve multiple groups/groups/multiple?group_ids=string
  • POSTJoin groups/groups/subscribeRequest membership to one or more groups. <br /><br /> NOTE: Any group with a has_questions field set to true will also require answers to the groups' new…
  • GETRetrieve a group/groups/:group_id
  • POSTSubmit group answers/groups/:group_id/answersSubmits answers to a groups' membership questionnaire. <br /><br /> The request body should be a JSON object mapping each question from the group…
  • POSTContact group moderators/groups/:group_id/contact
  • POSTLeave a group/groups/:group_id/unsubscribe

photos

  • POSTCreate a photo/photos
  • GETRetrieve multiple photos/photos/multiple?photo_ids=string&device_pixel_ratio=1
  • DELETEDelete a photo/photos/:photo_id
  • POSTRotate a photo/photos/:photo_id/rotate?degrees=0&device_pixel_ratio=1

messages

  • GETList conversations/conversations?category=inbox&page=1&per_page=10&num_messages=10&include_num_unread=0&device_pixel_ratio=1
  • PUTArchive all conversations/conversations/archive-all
  • PUTMark all conversations as read/conversations/mark-all-read
  • GETSearch conversations/conversations/search?search=string&page=1&per_page=10&device_pixel_ratio=1Searches all conversations except blocked conversations.
  • DELETEDelete conversation/conversations/:conversation_id?message_id=string
  • PUTArchive conversation/conversations/:conversation_id/archive
  • PUTBlock conversation/conversations/:conversation_id/block
  • PUTMark conversation as read/conversations/:conversation_id/mark-read
  • GETList conversation messages/conversations/:conversation_id/messages?page=1&per_page=10&device_pixel_ratio=1&include_conversation=0
  • POSTReply to conversation/conversations/:conversation_id/reply
  • POSTReport conversation/conversations/:conversation_id/report
  • PUTUnarchive conversation/conversations/:conversation_id/unarchive
  • PUTUnblock conversation/conversations/:conversation_id/unblock

stories

  • GETList stories/stories?page=1&per_page=20&sort_by=date&latitude=0.0&longitude=0.0&device_pixel_ratio=1
  • POSTSubmit a story/stories
  • GETRetrieve a story/stories/:story_id?device_pixel_ratio=1
  • PUTLike a story/stories/:story_id/like?device_pixel_ratio=1
  • PUTUnlike a story/stories/:story_id/unlike?device_pixel_ratio=1
  • POSTRecord story viewed/stories/:story_id/viewedRecords every time a user views the full story (and not just a preview or snippet),

misc

  • POSTSend feedback/feedbackAllows users to send feedback about the trashnothing.com site or apps.

API details

Base URL
https://trashnothing.com/api/v1.3
Authentication
An API key in the api_key query parameter
OAuth 2.0 (authorization code flow) with 1 scope
OAuth 2.0 (implicit flow) with 1 scope
Operations
76 operations on 67 pathsGET 29POST 21PUT 20DELETE 6
Main resources
users 26posts 19messages 13groups 7stories 6photos 4misc 1
Response formats
application/json
Description format
OpenAPI 3.0.0, API version 1.3
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the trash nothing in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the trash nothing collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the api_key query parameter. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Retrieve current user” (GET /users/me), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the trash nothing?

This is the REST API for [trashnothing.com](https://trashnothing.com). To learn more about the API or to register your app for use with the API visit the… It is listed under Social and has 76 endpoints.

Who publishes the trash nothing?

It is listed from Trash Nothing's public API description (an OpenAPI document), not published by Trash Nothing on Swastik Codes. Anyone who controls trashnothing.com can claim the profile by adding a DNS TXT record.

What is the base URL of the trash nothing?

Requests go to https://trashnothing.com/api/v1.3. Endpoint paths are added to this base URL.

How do I authenticate with the trash nothing?

It accepts 3 methods: an API key in the api_key query parameter; OAuth 2.0 (authorization code flow) with 1 scope; OAuth 2.0 (implicit flow) with 1 scope.

How many endpoints does the trash nothing have?

76 operations on 67 paths (29 GET, 21 POST, 20 PUT, 6 DELETE). The largest groups are users, posts, messages, groups.

Is forking the trash nothing free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.