trash nothing

List conversations

GET

/conversations

messages

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://trashnothing.com/api/v1.2/conversations'

Response Example

200 - Example 1

{
    "conversations": [
        {
            "archived": false,
            "blocked": false,
            "conversation_id": 38914,
            "last_message_date": "2019-07-24T22:51:09",
            "messages": [
                {
                    "content": "Here are some photos and the directions for pick up.",
                    "date": "2019-07-24T22:29:10",
                    "email_attachments": [
                        "Directions and map.pdf"
                    ],
                    "from_user_id": 2946512,
                    "message_id": 10199633,
                    "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"
                        }
                    ],
                    "subject": "Dining Table and 4 Chairs",
                    "to_user_id": 119458
                }
            ],
            "num_unread_messages": 1,
            "user": {
                "about_me": "Just an old fisherman looking to reuse more.",
                "country": "GB",
                "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",
                "user_id": 2946512,
                "username": "fred gibson"
            }
        }
    ],
    "num_unread": 0,
    "page": 0,
    "per_page": 0
}

Request

Query Params

Responses

🟢200The conversations and paging data.

application/json

Body

conversations

array[object (Conversation) {7}]

optional

archived

boolean

optional

Whether or not this conversation is archived.

blocked

boolean

optional

Whether or not this conversation is blocked.

conversation_id

string

optional

last_message_date

string <date-time>

optional

The UTC date and time of the last message in this conversation.

messages

array[object (Message) {8}]

optional

The latest messages in this conversation.

num_unread_messages

integer

optional

The count of how many unread messages this conversation has.

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"}

num_unread

integer

optional

If the include_num_unread parameter is set to 1, this will be set to the total number of conversations that have unread messages matching the query parameters of the request. If the include_num_unread parameter is set to 0, this will be null.

page

integer

optional

per_page

integer

optional

🟠400Invalid parameters.

Modified at 2022-09-11 18:59:47

Mark all conversations as read