# Get Chat by ID

**GET /api/v1/chats/{chatID}**

Retrieves details for a specific chat session, optionally including messages.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters
- **chatID** (integer)
  Chat ID

### Query parameters
- **include_messages** (boolean)
  Include messages in the response


## Responses
### 200
Chat details

#### Body: application/json (object)
- **created_at** (string)

- **id** (integer)

- **messages** (array[object])

- **metadata** (object)
  Use the structured type
- **organization_id** (integer)

- **tags** (array[string])
  Parsed tags
- **title** (string)

- **updated_at** (string)

- **user_id** (integer)
  Nullable for anonymous chats

### 400
Invalid chat ID

#### Body: application/json (object)
- ***** (string)


### 401
Unauthorized (JWT invalid/missing or Org ID not found)

#### Body: application/json (object)
- ***** (string)


### 403
Permission denied (Chat doesn't belong to user's org)

#### Body: application/json (object)
- ***** (string)


### 404
Chat not found

#### Body: application/json (object)
- ***** (string)


### 500
Failed to get chat or messages

#### Body: application/json (object)
- ***** (string)



[Powered by Bump.sh](https://bump.sh)