---
title: "Fetch a window of one-on-one turns around one chat id (for jump-to)."
method: POST
path: "/v1/get_chat_around"
tags: ["Conversation"]
---

# Fetch a window of one-on-one turns around one chat id (for jump-to).

`POST /v1/get_chat_around`

## Request

- Base URL: `https://partner.mindupload.app`
- URL: `https://partner.mindupload.app/v1/get_chat_around`
- Auth: API key in header `X-Partner-Key`

Load a contiguous window of one-on-one turns around `chat_id` so a client can jump from a find hit into the live dialogue. `before` and `after` cap neighbors on each side of the anchor.

## Request body

- object
  - `preferred_language` string, nullable: BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages.
  - `username` string, required: The end-user's username.
  - `password` string, required: The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage.
  - `clone_id` string, required: Owner AI consciousness id from `get_clones` (required for one-on-one jump).
  - `chat_id` string, required: One-on-one chat turn id.
  - `before` integer: How many earlier neighbors to include around the anchor id.
  - `after` integer: How many later neighbors to include around the anchor id.

## Response `200`

Result envelope — check the success field.

- object
  - `success` boolean: Whether the call succeeded.
  - `error_message` string, nullable: Human-readable reason when success is false.
  - `error_code` string
  - `chats` object[], nullable: One-on-one turns returned by this operation.
  - `media_thumbnails` object, nullable: Mapping from an external media URL in a result to its preferred display URL (normally a retained thumbnail).
  - `media_fallbacks` object, nullable: Mapping from a provably expired signed image URL to a safe legacy display candidate.
  - `anchor_chat_id` string, nullable: Echo of the one-on-one chat id the window is centered on.

## Other responses

- `400`: Invalid request payload.
- `401`: Missing or invalid partner key.
- `403`: Partner is not authorized for this operation.
- `404`: The anchor turn is gone — deleted, or not part of this conversation. Show the reader that the turn no longer exists rather than retrying.
- `429`: Rate limit exceeded — retry later.
- `500`: Internal server error.

---

[API](https://skmtc.dev/mindupload/apis/mind-upload-partner-api.md) · [All operations](https://skmtc.dev/mindupload/apis/mind-upload-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mindupload/apis/mind-upload-partner-api/revisions/0371bdf78533?raw)