---
title: "GET /v1/org/{org_id}/chat_history"
method: GET
path: "/v1/org/{org_id}/chat_history"
tags: ["lance.history"]
---

# GET /v1/org/{org_id}/chat_history

`GET /v1/org/{org_id}/chat_history`

## Request

- Base URL: `https://api.lance.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lance.app/v1/org/{org_id}/chat_history`
- Auth: HTTP bearer

## Path parameters

- `org_id` string, required: a string matching the pattern ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

## Query parameters

- `limit` string: a string to be decoded into a number
- `cursor` string
- `bundle_id` string
- `thread_id` string

## Response `200`

Success

- object
  - `messages` object[], required
    - `direction` 'user' | 'agent', required
    - `content` string, required
    - `bundle_id` string, nullable, required
    - `thread_id` string, required
    - `created_at` string, required
    - `result` union
      - object
        - `kind` 'build', required
        - `version` string, nullable, required
        - `build_number` number, nullable, required
        - `state` string, required
        - `testers` object[]
          - `email` string, required
          - `status` string, required
        - `failure` object
          - `error_code` string, required: a string at least 1 character(s) long
          - `step` string, nullable
          - `first_error` string, nullable
          - `hint` string, nullable
          - `log_url` string, nullable
          - `log_tail` string[]
          - `next_actions` string[]
          - `source_door` string, nullable
      - object
        - `kind` 'metadata', required
        - `fields_changed` string[], required
      - object
        - `kind` 'task', required
        - `status` 'completed' | 'failed' | 'blocked', required
        - `summary` string
    - `turn_end` 'no_receipt'
    - `grounded` boolean
    - `tools_completed` number
  - `next_cursor` string, nullable, required

## Other responses

- `400`: The request did not match the expected schema
- `401`: Error
- `403`: Error
- `500`: Unauthorized

---

[API](https://skmtc.dev/lance/apis/lance-api.md) · [All operations](https://skmtc.dev/lance/apis/lance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lance/apis/lance-api/revisions/70af239f0fc2?raw)