# List Chats

```
GET 
/v1/chats
```

List the N most recent chats for the authenticated user.

`path`, when provided, is used as an affinity hint: chats whose location table records a matching path are bubbled to the top of the list, but the result is never filtered down to only path-matches. This guarantees the selector is never empty when chats exist — the original strict-filter behaviour silently dropped every chat after a redirect or query-string drift between writer and reader.

Cursor-paginated. The wire query parameter is `exclusiveStartKey` (what the cURL tab and the parameter table show); the TypeScript SDK takes it as the `exclusiveStartKey` option and the Python SDK as the `exclusive_start_key` keyword — one parameter, spelled per language. Pass the previous page's `nextKey` and stop when it comes back `null` — or let `iterAll()` / `iter_all()` drive the cursor for you (see the SDKs page, "Pagination").

## Request[​](#request "Enlace directo al request")

## Responses[​](#responses "Enlace directo al Responses")

* 200
* 404
* 422

Successful Response

Not found

Validation Error