List Conversations
curl --request GET \
  --url https://integration.getmateo.com/api/v1/conversation \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "random uuid",
    "created_at": "now()",
    "updated_at": "now()",
    "organisation_id": "random uuid",
    "subject": "<string>",
    "status": "open",
    "assignee_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "unread": true,
    "channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "channel_type": "email",
    "contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "external_id": "<string>",
    "tags": {},
    "is_spam": false,
    "inbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "latest_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "latest_inbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "latest_message_created_at": "<string>",
    "latest_inbound_message_created_at": "<string>"
  }
]

Authorizations

Authorization
string
header
required

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

Headers

Range
string

Limiting and Pagination

Range-Unit
string
default:items

Limiting and Pagination

Query Parameters

id
string

Conversation ID

created_at
string

Conversation creation date

updated_at
string

Latest update

organisation_id
string

Organisation ID

subject
string

Subject of conversation

status
string

Status of conversation

assignee_id
string

Assignee ID

unread
string

Is conversation on unread?

channel_id
string

Channel ID

channel_type
string

Channel Type of Conversation

contact_id
string

Contact ID

external_id
string

External ID

tags
string

Given tags of conversation

is_spam
string

Is conversation marked as spam?

inbox_id
string

Inbox ID

latest_message_id
string

Latest message ID

latest_inbound_message_id
string

Latest inbound message ID

latest_message_created_at
string

Latest message creation date

latest_inbound_message_created_at
string

Latest inbound message creation date

select
string

Filtering Columns

order
string

Ordering

offset
string

Limiting and Pagination

limit
string

Limiting and Pagination

Response

200 - application/json

OK

id
string<uuid>
default:random uuid

Conversation ID

created_at
string<timestamp with time zone>
default:now()

Conversation creation date

updated_at
string<timestamp with time zone>
default:now()

Latest update

organisation_id
string<uuid>
default:random uuid

Organisation ID

subject
string<text> | null

Subject of conversation

status
enum<string>
default:open

Status of conversation

Available options:
open,
closed,
archived
assignee_id
string<uuid> | null

Assignee ID

unread
boolean | null

Is conversation on unread?

channel_id
string<uuid>

Channel ID

channel_type
enum<string>

Channel Type of Conversation

Available options:
email,
sms,
whatsapp,
instagram,
facebook,
google_business_messaging,
postal
contact_id
string<uuid> | null

Contact ID

external_id
string<text> | null

External ID

tags
object | null

Given tags of conversation

is_spam
boolean
default:false

Is conversation marked as spam?

inbox_id
string<uuid>

Inbox ID

latest_message_id
string<uuid> | null

Latest message ID

latest_inbound_message_id
string<uuid> | null

Latest inbound message ID

latest_message_created_at
string<timestamp with time zone> | null

Latest message creation date

latest_inbound_message_created_at
string<timestamp with time zone> | null

Latest inbound message creation date