logs

Retrieve the figures of the conversation logs

Conversations, questions, distinct people, credits and thumbs over the same filters as GET /v1/logs/conversations (without cursor and limit), with the conversations per channel. With no filter it covers every log still kept (90 days). Needs the right to edit assistants. Costs nothing.

GET/v1/logs/conversations/stats

Request

curl --request GET \
  --url 'https://api.lookio.app/v1/logs/conversations/stats' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.lookio.app/v1/logs/conversations/stats"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://api.lookio.app/v1/logs/conversations/stats", {
  method: "GET",
  headers: {
    "Authorization": "<api-key>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.lookio.app/v1/logs/conversations/stats");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.lookio.app/v1/logs/conversations/stats", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.lookio.app/v1/logs/conversations/stats"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.lookio.app/v1/logs/conversations/stats")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "conversations": 120,
    "questions": 310,
    "people": 64,
    "credits": 9300,
    "thumbs_up": 41,
    "thumbs_down": 7,
    "by_channel": {
      "widget": 80,
      "api": 35,
      "mcp": 5
    }
  },
  "request_id": "req_01K9X7M2Q4"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

Requires assistants:write.

The totals behind the list of conversations, over the same filters (channel, widget_id, api_key_id, assistant_id, rating, end_user, q, from, to) and without cursor or limit. With no filter it covers every conversation still kept, which is the last 90 days.

people counts distinct end_user values, and a conversation without one counts as one person. by_channel gives the conversations of each channel, with zero for a channel that has none.

This endpoint was GET /v1/logs/stats before 18 October 2026. The same permissions as the list apply. See Logs.

Authorizations

Authorizationbearerin headerrequired

Query parameters

channelstringlength: ≥ 1 chars

Only the conversations from these channels, comma-separated: widget (visitors of a widget), api (an API key through REST, the CLI or the SDK), mcp (an API key through the MCP server). Default: all three.

widget_idstringpattern: ^wdg_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Only this widget's visitors.

api_key_idstringlength: 1–64 chars

Only the conversations asked with this API key (the api_key.id of a conversation in these logs).

assistant_idstringpattern: ^ast_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Only the conversations with this assistant.

ratingenum<string>one of: up, down, rated, unrated

down: at least one thumbs down (where the assistant failed). up: at least one thumbs up. rated: any thumb. unrated: none.

end_userstringlength: 1–200 chars

Only this person: a widget visitor's random id, or the end_user your product sends with its questions.

qstringlength: 1–200 chars

Words in the title or in any question or answer, without regard to case.

fromstring

Only conversations with activity since this ISO 8601 date or timestamp.

tostring

Only conversations started before this ISO 8601 date or timestamp.

Response

application/json

Retrieve the figures of the conversation logs

dataobjectrequired

Show child attributes

data.conversationsintegerrequired

data.questionsintegerrequired

Questions asked, so answers given.

data.peopleintegerrequired

Distinct end_user values. A conversation without one counts as one person.

data.creditsintegerrequired

data.thumbs_upintegerrequired

data.thumbs_downintegerrequired

data.by_channelobjectrequired

Conversations per channel.

Show child attributes

data.by_channel.widgetintegerrequired

data.by_channel.apiintegerrequired

data.by_channel.mcpintegerrequired

request_idstringrequired

{ "data": { "conversations": 120, "questions": 310, "people": 64, "credits": 9300, "thumbs_up": 41, "thumbs_down": 7, "by_channel": { "widget": 80, "api": 35, "mcp": 5 } }, "request_id": "req_01K9X7M2Q4" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>" }, "request_id": "<string>" }

Retrieve the figures of the conversation logs

Authorizations

Query parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown