Skip to main content
GET
/
conversations
List conversations
curl --request GET \
  --url https://api.managem.co.uk/conversations \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "source": {
      "type": "ORDER",
      "id": "<string>"
    },
    "userA": {
      "id": "<string>",
      "username": "<string>",
      "reviews": 123,
      "rating": 123,
      "score": 123,
      "sales": 123,
      "purchases": 123,
      "joined": "2023-11-07T05:31:56Z",
      "avatar": "<string>",
      "cover": "<string>",
      "profile": "<string>"
    },
    "userB": {
      "id": "<string>",
      "username": "<string>",
      "reviews": 123,
      "rating": 123,
      "score": 123,
      "sales": 123,
      "purchases": 123,
      "joined": "2023-11-07T05:31:56Z",
      "avatar": "<string>",
      "cover": "<string>",
      "profile": "<string>"
    },
    "locked": true,
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "lastMessage": {
      "id": "<string>",
      "conversationId": "<string>",
      "sender": {
        "id": "<string>",
        "username": "<string>",
        "reviews": 123,
        "rating": 123,
        "score": 123,
        "sales": 123,
        "purchases": 123,
        "joined": "2023-11-07T05:31:56Z",
        "avatar": "<string>",
        "cover": "<string>",
        "profile": "<string>"
      },
      "body": "<string>",
      "createdAt": "<string>",
      "viewedAt": "<string>",
      "attachments": [
        {
          "id": "<string>",
          "imageId": "<string>",
          "url": "<string>"
        }
      ]
    }
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1

Page number, defaults to 1

Required range: x >= 1
size
integer
default:20

Results per page, defaults to 20

Required range: 1 <= x <= 50
sort
enum<string>
default:updatedAt

Field to sort by

Available options:
createdAt,
updatedAt
direction
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Response

200 - application/json

List of conversations

id
string
required

Unique identifier for the conversation

source
object
required

Conversation source

userA
object
required

First participant

userB
object
required

Second participant

locked
boolean
required

Whether the conversation is locked

createdAt
string | null

Timestamp when the conversation was created

updatedAt
string | null

Timestamp when the conversation was last updated

lastMessage
object

Latest message in the conversation