Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

get
/conversations/
Authorizations
AuthorizationstringRequired

Token credential sent in the Authorization header, in the form: Token <your-token>. Requires a staff (admin) account.

Query parameters
pageintegerOptional

The page number to return.

Default: 1
limitintegerOptional

The number of items to return per page.

Default: 10
sortstringOptional

Orders the results by one or more fields. Separate multiple fields with commas. Prefix a field with a hyphen (-) for descending order.

Example: -id
statusstring · enumOptional

Where a moderated conversation stands. Private messages, and reviews or questions written before moderation existed, carry null instead.

  • pending — waiting in the moderation queue
  • approved — published on the storefront
  • rejected — turned down; the author was e-mailed the reason
Example: pendingPossible values:
conversation_typestring · enumOptional

The kind of conversation. See Conversation Kinds under Conversations.

  • review — a customer's rated verdict on an order item they bought; moderated
  • question — a customer's question about a product; moderated
  • message — private correspondence between one customer and one seller; never moderated and never listed on the storefront
Example: reviewPossible values:
is_publicbooleanOptional

Filter by storefront visibility.

is_answeredbooleanOptional

Filter by whether the last word was the seller's.

productintegerOptional

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.

Example: 3412
product_base_codestringOptional

A product base code. Matches conversations about any product with that base code, or about any order item that sold one of them.

Example: BOOT-001
order_itemintegerOptional

An order item identifier. Matches conversations about that order item. A value that is not a number is rejected with 400.

Example: 90211
order_numberstringOptional

An order number. Matches conversations about any order item of that order.

Example: 2408231200123
item_typestring · enumOptional

Filter by what the conversation is about.

Possible values:
data_sourcestringOptional

Filter by the exact slug of the seller (data source).

Example: main-supplier
data_source_idintegerOptional

Filter by the exact identifier of the seller (data source).

Example: 8
user_idintegerOptional

Filter by the exact identifier of the customer who owns the conversation.

Example: 1001
user__first_namestringOptional

Case-insensitive partial match on the customer's first name.

user__last_namestringOptional

Case-insensitive partial match on the customer's last name.

created_date__gtstring · date-timeOptional

Conversations created after this moment.

created_date__gtestring · date-timeOptional

Conversations created at or after this moment.

created_date__ltstring · date-timeOptional

Conversations created before this moment.

created_date__ltestring · date-timeOptional

Conversations created at or before this moment.

modified_date__gtstring · date-timeOptional

Conversations last modified after this moment.

modified_date__gtestring · date-timeOptional

Conversations last modified at or after this moment.

modified_date__ltstring · date-timeOptional

Conversations last modified before this moment.

modified_date__ltestring · date-timeOptional

Conversations last modified at or before this moment.

last_message_date__gtstring · date-timeOptional

Conversations whose latest message was posted after this moment.

last_message_date__gtestring · date-timeOptional

Conversations whose latest message was posted at or after this moment.

last_message_date__ltstring · date-timeOptional

Conversations whose latest message was posted before this moment.

last_message_date__ltestring · date-timeOptional

Conversations whose latest message was posted at or before this moment.

Responses
200

A paginated list of conversations.

application/json

A paginated list of conversations.

countintegerOptional

Total number of conversations matching the request.

nextstring · nullableOptional

URL of the next page, or null if this is the last page.

previousstring · nullableOptional

URL of the previous page, or null if this is the first page.

get/conversations/
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?