List conversations
Returns a paginated list of conversations of every kind — reviews, questions and private messages — including those still pending and those rejected. Each conversation carries the customer's contact details, its messages, the item it is about, its rating, its moderation status and its audit trail (events, oldest first).
Use ?status=pending for the moderation queue. Private messages and conversations written before moderation existed have a null status and are not matched by any status value.
product and product_base_code match both anchors a conversation about a product can have: the product itself (questions) and any order item that sold it (reviews and private messages).
Results are ordered by last_message_date, most recent first. Use sort to change the ordering.
Token credential sent in the Authorization header, in the form: Token <your-token>. Requires a staff (admin) account.
The page number to return.
1The number of items to return per page.
10Orders the results by one or more fields. Separate multiple fields with commas. Prefix a field with a hyphen (-) for descending order.
-idWhere a moderated conversation stands. Private messages, and reviews or questions written before moderation existed, carry null instead.
pending— waiting in the moderation queueapproved— published on the storefrontrejected— turned down; the author was e-mailed the reason
pendingPossible values: The kind of conversation. See Conversation Kinds under Conversations.
review— a customer's rated verdict on an order item they bought; moderatedquestion— a customer's question about a product; moderatedmessage— private correspondence between one customer and one seller; never moderated and never listed on the storefront
reviewPossible values: Filter by storefront visibility.
Filter by whether the last word was the seller's.
A product identifier. Matches conversations about the product itself and conversations about any order item that sold it. A value that is not a number is rejected with 400.
3412A product base code. Matches conversations about any product with that base code, or about any order item that sold one of them.
BOOT-001An order item identifier. Matches conversations about that order item. A value that is not a number is rejected with 400.
90211An order number. Matches conversations about any order item of that order.
2408231200123Filter by what the conversation is about.
Filter by the exact slug of the seller (data source).
main-supplierFilter by the exact identifier of the seller (data source).
8Filter by the exact identifier of the customer who owns the conversation.
1001Case-insensitive partial match on the customer's first name.
Case-insensitive partial match on the customer's last name.
Conversations created after this moment.
Conversations created at or after this moment.
Conversations created before this moment.
Conversations created at or before this moment.
Conversations last modified after this moment.
Conversations last modified at or after this moment.
Conversations last modified before this moment.
Conversations last modified at or before this moment.
Conversations whose latest message was posted after this moment.
Conversations whose latest message was posted at or after this moment.
Conversations whose latest message was posted before this moment.
Conversations whose latest message was posted at or before this moment.
A paginated list of conversations.
A paginated list of conversations.
Total number of conversations matching the request.
URL of the next page, or null if this is the last page.
URL of the previous page, or null if this is the first page.
A filter value is not valid — for example a status or conversation_type that is not one of the listed values, or a product or order_item that is not a number, which is answered on that field with Enter a number.
Authentication credentials were not provided or are invalid.
The authenticated user does not have administrator privileges.
The requested page does not exist — it is past the last page or not a valid page number. Paginated list endpoints answer with 404 rather than an empty page. The literal value last is accepted and returns the final page.
GET /api/v1/remote/1/conversations/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 5821,
"subject": "Leather Boot",
"user": {
"id": 1001,
"first_name": "Jane",
"last_name": "Doe",
"email": "jane.doe@example.com",
"phone": "05321234567",
"gender": "female"
},
"datasource": {
"pk": 8,
"name": "Main Supplier",
"slug": "main-supplier",
"title": "Main Supplier Co.",
"supplier_code": "SUP-001",
"address": "123 Example Street",
"email": "seller@example.com",
"phone_number": "+902121234567",
"fax_number": null,
"kep_address": "seller@hs01.kep.tr",
"mersis_number": "0123456789012345",
"trade_association": "Chamber of Commerce",
"extras": {},
"price_list": 2,
"stock_list": 2,
"is_active": true
},
"item_object": {
"pk": 90211,
"product": {
"pk": 3412,
"name": "Leather Boot",
"sku": "BOOT-001-38",
"absolute_url": "/leather-boot/",
"product_images": []
},
"status": "550",
"order_number": "2408231200123"
},
"item_content": "orderitem",
"message_set": [
{
"id": 7710,
"message_content": "Comfortable and well made, but the left boot squeaks.",
"user_type": "registered",
"content_object": {
"id": 1001,
"email": "jane.doe@example.com",
"first_name": "Jane",
"last_name": "Doe",
"phone": "05321234567",
"gender": "female"
},
"content_type": "user",
"created_date": "2026-08-12T09:14:03.120000Z"
}
],
"conversation_type": "review",
"last_message_date": "2026-08-12T09:14:03.120000Z",
"is_public": false,
"is_answered": false,
"events": [
{
"id": 44120,
"event_type": "submitted",
"reason_detail": null,
"rejection_reason": null,
"rejection_reason_text": null,
"message_content": "Comfortable and well made, but the left boot squeaks.",
"user": null,
"request_headers": null,
"created_date": "2026-08-12T09:14:03.131000Z"
},
{
"id": 44121,
"event_type": "rejected",
"reason_detail": "The third sentence contains a slur.",
"rejection_reason": "profanity",
"rejection_reason_text": "Posts must not contain profanity or insults.",
"message_content": null,
"user": 17,
"request_headers": {
"X-Omnitron-Session": "1",
"X-Omnitron-User": "moderator@brand.com;moderator;57"
},
"created_date": "2026-08-12T11:02:44.581000Z"
}
],
"rating": 2,
"status": "rejected"
}
]
}Last updated
Was this helpful?

