Skip to main content
GET
/
api
/
v1
/
chats
/
{business_id}
List chats for a business
curl --request GET \
  --url https://api.izap.ai/api/v1/chats/{business_id} \
  --header 'Authorization: Bearer <token>'
{
  "chats": [
    {
      "id": "c1a2b3c4-1234-4a5b-9c8d-abcdef123456",
      "business_id": "6a1f2e2e-1c34-4e2a-9c3e-1234567890ab",
      "kind": "real",
      "timestamp": "2026-07-01T12:00:00Z",
      "last_message": {
        "content": "Oi, tudo bem?",
        "status": "delivered",
        "timestamp": "2026-07-01T12:00:00Z"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 30,
    "total_count": 1
  }
}

Authorizations

​
Authorization
string
header
required

JWT access token obtained from POST /api/v1/auth/jwt/login, the OAuth token endpoint, or a business-scoped API token. Some Business/Chat/Template/Scheduling endpoints alternatively accept HTTP Basic credentials scoped to the business slug.

Path Parameters

​
business_id
string<uuid>
required

Query Parameters

​
kind
enum<string>
default:trainer

'real' returns customer conversations created from WhatsApp; 'trainer' returns AI Trainer sandbox chats.

Available options:
trainer,
real,
all
​
page
integer
default:1
Required range: x >= 1
​
page_size
integer
default:30
Required range: 1 <= x <= 100
​
messages_per_chat
integer
default:1
Required range: 1 <= x <= 200

Response

Paginated chat list.

​
chats
object[]
​
pagination
object