Get all conversation the authenticated user has created or has access to
GET/conversations/
v2
GET
conversation-list-conversations
Request
Responses
application/json
The conversations list ordered by creation date
- Schema documentation
- Example
- JSON Schema
- Array[
- *object
- categoryobject
- categoryIdstring (uuid)required
- namestringrequired
- referenceTypearray of string (one of: unspecified, server, project, organisation, extensionInstance)required
- Array[
- *string (one of: unspecified, server, project, organisation, extensionInstance)
]
- conversationIdstring (uuid)required
- createdAtstring (date-time)required
- createdByobject
- activeboolean
- avatarRefIdstring
- clearNamestring
- departmentstring (one of: development, mail, accounting, cloudHosting, customerService, productManagement, generic)
- userIdstringrequired
- lastMessageobject
- createdAtstring (date-time)required
- createdByobject
- activeboolean
- avatarRefIdstring
- clearNamestring
- departmentstring (one of: development, mail, accounting, cloudHosting, customerService, productManagement, generic)
- userIdstringrequired
- lastMessageAtstring (date-time)
- lastMessageByobject
- activeboolean
- avatarRefIdstring
- clearNamestring
- departmentstring (one of: development, mail, accounting, cloudHosting, customerService, productManagement, generic)
- userIdstringrequired
- mainUserobjectrequired
- activeboolean
- avatarRefIdstring
- clearNamestring
- departmentstring (one of: development, mail, accounting, cloudHosting, customerService, productManagement, generic)
- userIdstringrequired
- notificationRolesarray of string (one of: customer_owner, customer_accountant, customer_member, project_owner, project_emailadmin, project_external)
- Array[
- *string (one of: customer_owner, customer_accountant, customer_member, project_owner, project_emailadmin, project_external)
]
relatedToone of 7 alternatives
- Alternativeobject
- aggregate"user"required
- domain"user"required
- idstringrequired
- Alternativeobject
- aggregate"customer"required
- domain"customer"required
- idstringrequired
- Alternativeobject
- aggregate"project"required
- domain"project"required
- idstringrequired
- Alternativeobject
- aggregate"appinstallation"required
- domain"app"required
- idstringrequired
- Alternativeobject
- aggregate"placementgroup"required
- domain"project"required
- idstringrequired
- Alternativeobject
- aggregate"extensionInstance"required
- domain"extension"required
- idstringrequired
- Alternativeobject
- aggregate"container"required
- domain"container"required
- idstringrequired
relationsarray of object
- Array[
- *object
- aggregatestringrequired
- domainstringrequired
- idstringrequired
]
sharedWithone of 4 alternatives
- Alternativeobject
- aggregate"user"required
- domain"user"required
- idstringrequired
- Alternativeobject
- aggregate"customer"required
- domain"customer"required
- idstringrequired
- Alternativeobject
- aggregate"project"required
- domain"project"required
- idstringrequired
- Alternativeobject
- aggregate"placementgroup"required
- domain"project"required
- idstringrequired
shortIdstring
required
statusstring (one of: open, closed, answered, inProgress, waiting)
required
titlestring
required
visibilitystring (one of: shared, private)
required
]
Content-Type: application/json
[
{
"category": {
"categoryId": "f0f86186-0a5a-45b2-aa33-502777496347",
"name": "string",
"referenceType": [
"unspecified"
]
},
"conversationId": "f0f86186-0a5a-45b2-aa33-502777496347",
"createdAt": "2025-11-03T18:08:33.386Z",
"createdBy": {
"active": true,
"avatarRefId": "string",
"clearName": "string",
"department": "development",
"userId": "string"
},
"lastMessage": {
"createdAt": "2025-11-03T18:08:33.386Z",
"createdBy": {
"active": true,
"avatarRefId": "string",
"clearName": "string",
"department": "development",
"userId": "string"
}
},
"lastMessageAt": "2025-11-03T18:08:33.386Z",
"lastMessageBy": {
"active": true,
"avatarRefId": "string",
"clearName": "string",
"department": "development",
"userId": "string"
},
"mainUser": {
"active": true,
"avatarRefId": "string",
"clearName": "string",
"department": "development",
"userId": "string"
},
"notificationRoles": [
"customer_owner"
],
"relatedTo": {
"aggregate": "user",
"domain": "user",
"id": "string"
},
"relations": [
{
"aggregate": "string",
"domain": "string",
"id": "string"
}
],
"sharedWith": {
"aggregate": "user",
"domain": "user",
"id": "string"
},
"shortId": "string",
"status": "open",
"title": "string",
"visibility": "shared"
}
]
{
"items": {
"properties": {
"category": {
"properties": {
"categoryId": {
"format": "uuid",
"type": "string"
},
"name": {
"type": "string"
},
"referenceType": {
"items": {
"enum": [
"unspecified",
"server",
"project",
"organisation",
"extensionInstance"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"categoryId",
"name",
"referenceType"
],
"type": "object"
},
"conversationId": {
"format": "uuid",
"type": "string"
},
"createdAt": {
"format": "date-time",
"type": "string"
},
"createdBy": {
"properties": {
"active": {
"type": "boolean"
},
"avatarRefId": {
"type": "string"
},
"clearName": {
"type": "string"
},
"department": {
"enum": [
"development",
"mail",
"accounting",
"cloudHosting",
"customerService",
"productManagement",
"generic"
],
"type": "string"
},
"userId": {
"type": "string"
}
},
"required": [
"userId"
],
"type": "object"
},
"lastMessage": {
"properties": {
"createdAt": {
"format": "date-time",
"type": "string"
},
"createdBy": {
"properties": {
"active": {
"type": "boolean"
},
"avatarRefId": {
"type": "string"
},
"clearName": {
"type": "string"
},
"department": {
"enum": [
"development",
"mail",
"accounting",
"cloudHosting",
"customerService",
"productManagement",
"generic"
],
"type": "string"
},
"userId": {
"type": "string"
}
},
"required": [
"userId"
],
"type": "object"
}
},
"required": [
"createdAt"
],
"type": "object"
},
"lastMessageAt": {
"format": "date-time",
"type": "string"
},
"lastMessageBy": {
"properties": {
"active": {
"type": "boolean"
},
"avatarRefId": {
"type": "string"
},
"clearName": {
"type": "string"
},
"department": {
"enum": [
"development",
"mail",
"accounting",
"cloudHosting",
"customerService",
"productManagement",
"generic"
],
"type": "string"
},
"userId": {
"type": "string"
}
},
"required": [
"userId"
],
"type": "object"
},
"mainUser": {
"properties": {
"active": {
"type": "boolean"
},
"avatarRefId": {
"type": "string"
},
"clearName": {
"type": "string"
},
"department": {
"enum": [
"development",
"mail",
"accounting",
"cloudHosting",
"customerService",
"productManagement",
"generic"
],
"type": "string"
},
"userId": {
"type": "string"
}
},
"required": [
"userId"
],
"type": "object"
},
"notificationRoles": {
"items": {
"enum": [
"customer_owner",
"customer_accountant",
"customer_member",
"project_owner",
"project_emailadmin",
"project_external"
],
"type": "string"
},
"type": "array"
},
"relatedTo": {
"oneOf": [
{
"properties": {
"aggregate": {
"enum": [
"user"
],
"type": "string"
},
"domain": {
"enum": [
"user"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"customer"
],
"type": "string"
},
"domain": {
"enum": [
"customer"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"project"
],
"type": "string"
},
"domain": {
"enum": [
"project"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"appinstallation"
],
"type": "string"
},
"domain": {
"enum": [
"app"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"placementgroup"
],
"type": "string"
},
"domain": {
"enum": [
"project"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"extensionInstance"
],
"type": "string"
},
"domain": {
"enum": [
"extension"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"container"
],
"type": "string"
},
"domain": {
"enum": [
"container"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
}
]
},
"relations": {
"items": {
"properties": {
"aggregate": {
"type": "string"
},
"domain": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
"type": "array"
},
"sharedWith": {
"oneOf": [
{
"properties": {
"aggregate": {
"enum": [
"user"
],
"type": "string"
},
"domain": {
"enum": [
"user"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"customer"
],
"type": "string"
},
"domain": {
"enum": [
"customer"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"project"
],
"type": "string"
},
"domain": {
"enum": [
"project"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
},
{
"properties": {
"aggregate": {
"enum": [
"placementgroup"
],
"type": "string"
},
"domain": {
"enum": [
"project"
],
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"aggregate",
"domain"
],
"type": "object"
}
]
},
"shortId": {
"type": "string"
},
"status": {
"enum": [
"open",
"closed",
"answered",
"inProgress",
"waiting"
],
"type": "string"
},
"title": {
"type": "string"
},
"visibility": {
"enum": [
"shared",
"private"
],
"type": "string"
}
},
"required": [
"conversationId",
"shortId",
"title",
"createdAt",
"status",
"visibility",
"mainUser"
],
"type": "object"
},
"type": "array"
}
Usage examples
- cURL
- JavaScript SDK
- PHP SDK
$ curl \
--fail \
--location \
-H "Authorization: Bearer $MITTWALD_API_TOKEN" \
https://api.mittwald.de/v2/conversations?sort=createdAt&order=asc
import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.conversation.listConversations({
"queryParameters": {
"sort": [
"createdAt"
],
"order": [
"asc"
]
}
});
assertStatus(response, 200);
use \Mittwald\ApiClient\Generated\V2\Clients\Conversation\ListConversations\ListConversationsRequest;
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));
$request = (new ListConversationsRequest())
->withSort(["createdAt"])
->withOrder(["asc"]);
$response = $client->conversation()->listConversations($request);
var_dump($response->getBody();