DocsAPI & WebhooksList chats

List chats

GET
List conversations visible to the API principal

Uses the same tenant- and role-aware query as the workspace.

GET/api/v1/chats
Auth:Bearer sk_live_...

Request Parameters

FieldTypeRequiredDescription
lanestringOptionalcustomer or internal
unreadbooleanOptionaltrue returns unread chats
channelstringOptionalChannel kind
searchstringOptionalSearch text
limitintegerOptional1–500; default 100
offsetintegerOptional0–100000
Live Interactive API Playground
GET/api/v1/chatsRequests use your current ChatFleet workspace.
The playground makes a real request to this workspace. Use a scoped test key; never paste a production secret into a shared browser.

The key is not saved by this page.

Enter a scoped key, then run the request to inspect the live response here.

Code Examples

curl "http://localhost:8080/api/v1/chats?lane=customer&limit=100" \
  -H "Authorization: Bearer $PARRISCOPE_API_KEY"