Export chat sessions

curl --request GET \
  --url https://api.osvi.ai/v1/chat/export \
  --header 'API-Token: <api-key>'

const options = {method: 'GET', headers: {'API-Token': '<api-key>'}};

fetch('https://api.osvi.ai/v1/chat/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.osvi.ai/v1/chat/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "API-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.osvi.ai/v1/chat/export"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("API-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.osvi.ai/v1/chat/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["API-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "session_id": "8f3c2a1e-5b7d-4c9a-9e21-6d0f4b2a7c13",
      "customer_id": "+919812345678",
      "customer_id_truncated": false,
      "agent": {
        "uuid": "agent_Xk2pQ9rT",
        "name": "Order Support"
      },
      "mode": "ai",
      "status": "closed",
      "current_state": "resolution",
      "current_state_truncated": false,
      "help_requested": false,
      "created_at": "2026-10-09T10:02:11Z",
      "last_message_at": "2026-10-09T10:04:52Z",
      "message_count": 4,
      "user_message_count": 2,
      "assistant_message_count": 2,
      "input_fields": {
        "name": "Riya"
      },
      "state_fields": {
        "order_id": "ORD-5521"
      },
      "metadata_truncated": false,
      "transcript": [
        {
          "role": "user",
          "content": "Where is my order ORD-5521?",
          "created_at": "2026-10-09T10:02:11.087Z",
          "type": "message"
        }
      ],
      "transcript_truncated": false,
      "tool_calls": [
        {
          "request_id": "call_7Hq2",
          "name": "lookup_order",
          "called_at": "2026-10-09T10:02:13.412Z",
          "args": {
            "order_id": "ORD-5521"
          },
          "args_truncated": false,
          "status": "ok",
          "output": "{\"status\":\"shipped\",\"eta\":\"2026-10-11\"}",
          "output_truncated": false,
          "error_message": null,
          "error_message_truncated": false,
          "duration_ms": 184
        }
      ],
      "tool_calls_truncated": false
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 9,
    "total_count": 212,
    "per_page": 25,
    "records_cap": 1000,
    "capped": false,
    "snapshot_token": "c2e1f0a4b7d94e3a",
    "snapshot_restarted": false,
    "range": {
      "start": "2026-10-11T10:30:00Z",
      "end": "2026-10-12T10:30:00Z",
      "defaulted": true,
      "max_days": 31
    },
    "next_page": {
      "page": 2,
      "per_page": 25,
      "start_date": "2026-10-11T10:30:00Z",
      "end_date": "2026-10-12T10:30:00Z"
    }
  }
}

Chat

Export Chat Sessions

Returns chat sessions with their transcripts and tool calls, oldest first, as JSON or as Markdown ready to hand to Claude Code, claude.ai, a Codex agent or an MCP client.

Enabled per account. Ask Osvi support to turn it on; until then every call returns 403 feature_disabled.

Limits. With no dates the export covers the last 24 hours, and one request covers at most 31 days. A window serves at most 1,000 sessions, 25 per page. Each token may make 10 requests a minute and 1,000 a day, and an account may run 2 exports at once. Every 429 carries a Retry-After header.

GET

chat

export

Export chat sessions

curl --request GET \
  --url https://api.osvi.ai/v1/chat/export \
  --header 'API-Token: <api-key>'

const options = {method: 'GET', headers: {'API-Token': '<api-key>'}};

fetch('https://api.osvi.ai/v1/chat/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.osvi.ai/v1/chat/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "API-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.osvi.ai/v1/chat/export"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("API-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.osvi.ai/v1/chat/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["API-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "session_id": "8f3c2a1e-5b7d-4c9a-9e21-6d0f4b2a7c13",
      "customer_id": "+919812345678",
      "customer_id_truncated": false,
      "agent": {
        "uuid": "agent_Xk2pQ9rT",
        "name": "Order Support"
      },
      "mode": "ai",
      "status": "closed",
      "current_state": "resolution",
      "current_state_truncated": false,
      "help_requested": false,
      "created_at": "2026-10-09T10:02:11Z",
      "last_message_at": "2026-10-09T10:04:52Z",
      "message_count": 4,
      "user_message_count": 2,
      "assistant_message_count": 2,
      "input_fields": {
        "name": "Riya"
      },
      "state_fields": {
        "order_id": "ORD-5521"
      },
      "metadata_truncated": false,
      "transcript": [
        {
          "role": "user",
          "content": "Where is my order ORD-5521?",
          "created_at": "2026-10-09T10:02:11.087Z",
          "type": "message"
        }
      ],
      "transcript_truncated": false,
      "tool_calls": [
        {
          "request_id": "call_7Hq2",
          "name": "lookup_order",
          "called_at": "2026-10-09T10:02:13.412Z",
          "args": {
            "order_id": "ORD-5521"
          },
          "args_truncated": false,
          "status": "ok",
          "output": "{\"status\":\"shipped\",\"eta\":\"2026-10-11\"}",
          "output_truncated": false,
          "error_message": null,
          "error_message_truncated": false,
          "duration_ms": 184
        }
      ],
      "tool_calls_truncated": false
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 9,
    "total_count": 212,
    "per_page": 25,
    "records_cap": 1000,
    "capped": false,
    "snapshot_token": "c2e1f0a4b7d94e3a",
    "snapshot_restarted": false,
    "range": {
      "start": "2026-10-11T10:30:00Z",
      "end": "2026-10-12T10:30:00Z",
      "defaulted": true,
      "max_days": 31
    },
    "next_page": {
      "page": 2,
      "per_page": 25,
      "start_date": "2026-10-11T10:30:00Z",
      "end_date": "2026-10-12T10:30:00Z"
    }
  }
}

Pull your chat conversations, with every tool call the agent made, into Claude Code, claude.ai, a Codex agent or your own MCP client. Ask for JSON to process the data, or format=markdown to get one readable timeline per conversation, ready to hand to an LLM.

The export is enabled per account. Ask Osvi support to turn it on. Until then, every call returns 403 feature_disabled.

Use it with Claude Code

curl -s -H "API-Token: $OSVI_API_TOKEN" \
  "https://api.osvi.ai/v1/chat/export?format=markdown&per_page=25" \
  -o chats.md

claude "Read chats.md. Which tool calls failed, and what did the customer see when they did?"

With no dates, the export covers the last 24 hours. On claude.ai, attach the same file to a chat.

Reading every page

Each response tells you exactly how to ask for the next one:

JSON: send the parameters in meta.next_page as they are. It is null on the last page.
Markdown: the X-Next-Page header holds the next page’s query string, and the last line of the document repeats it.

next_page fixes the window to the timestamps page 1 used (meta.range). A window like “the last 24 hours” would otherwise move between requests and skip conversations. For the same reason, a request for page 2 or later without both start_date and end_date is rejected with range_required. If you filter by status or mode, next_page also carries a snapshot_token. It keeps page boundaries stable while conversations close or change hands during your export.

Limits

Limit	Value
Window when no dates are sent	Last 24 hours
Longest window per request	31 days. A bare date covers that whole day in IST
Conversations per window	1,000. Past that, narrow the window: `422 records_cap_exceeded`
Conversations per page	10 by default, 25 at most
Requests per token	10 a minute and 1,000 a day (UTC)
Exports running at once	2 per account. More returns `429 export_busy`
Time to build one page	5 seconds. Longer returns `503 export_timeout`

Every 429 carries a Retry-After header with the number of seconds to wait. Most HTTP clients and agent tools follow it automatically. Each conversation is bounded so one very long chat can’t crowd out the rest of the page:

Transcript: 500 messages and 30,000 characters
Tool calls: 500 events and 30,000 characters, counting tool names and IDs. Arguments over 4,000 characters are left out, outputs are cut at 8,000, and error messages at 2,000
Input and state fields: 30,000 characters each

When a bound applies, the matching *_truncated flag is true, so you never mistake a cut-off record for a complete one.

What’s in a tool call

Field	Meaning
`name`, `args`	The tool the agent called and the arguments it sent
`status`	`ok`, `error`, or `null` if no result was recorded (for example, the conversation ended mid-call)
`output`	What the tool returned to the agent
`error_message`	Why it failed, when `status` is `error`. `error_message_truncated` is `true` if it was cut short
`duration_ms`	How long the tool took

Knowledge-base lookups and the internal events behind buttons, carousels and date pickers are not listed as tool calls. Interactive prompts and replies show up in the transcript with type: "interaction".

Authorizations

API-Token

string

header

required

16-character API token associated with your OSVI account. Find it in your dashboard under Settings → API.

Query Parameters

start_date

string

Start of the window. A date (2026-10-09, the whole day in IST) or an ISO 8601 timestamp. Defaults to 24 hours before end_date. Required, with end_date, on pages after the first: copy both from meta.next_page.

end_date

string

End of the window, same formats. Defaults to now. The window may span at most 31 days.

page

integer

default:1

Page number. Follow meta.next_page rather than counting pages yourself.

per_page

integer

default:10

Sessions per page (max 25).

Required range: x <= 25

format

enum<string>

default:json

json, or markdown for one readable timeline per session. The .md path suffix works too.

Available options:

json,

markdown

status

string

Only sessions with these statuses. Accepts a comma-separated list.

mode

enum<string>

Only sessions in this mode. support means an operator has taken over.

Available options:

ai,

support

agent_uuid

string

Only sessions handled by this chat agent. Returns 404 if the agent is not on your account.

customer_id

string

Only one customer's sessions.

snapshot_token

string

Keeps page boundaries stable while sessions change status or mode. Comes back in meta when status or mode is filtered, and is already included in meta.next_page.

Response

One page of sessions. In Markdown, pagination comes back in the X-Total-Count, X-Current-Page, X-Total-Pages, X-Per-Page, X-Records-Cap, X-Capped, X-Range-Start, X-Range-End, X-Next-Page (a query string) and X-Snapshot-Token headers.

success

boolean

Example:

true

data

object[]

Show child attributes

Get Started

Going Deeper

Chat SDK

API Reference

Export Chat Sessions

Use it with Claude Code

Reading every page

Limits

What’s in a tool call

Authorizations

Query Parameters

Response

​Use it with Claude Code

​Reading every page

​Limits

​What’s in a tool call

Authorizations

Query Parameters

Response

Use it with Claude Code

Reading every page

Limits

What’s in a tool call