Get a customer

One customer: name, email, session fields, their chats and recent pages.

POST/v1/agent/action/get_customer

Get a customer

curl -X POST 'https://app.staging.mlive.chat/v1/agent/action/get_customer' \
  -H "Authorization: Bearer $MLC_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "01937c6e-0000-7000-8000-0000000000c1"
  }'

const res = await fetch('https://app.staging.mlive.chat/v1/agent/action/get_customer', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MLC_BOT_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": "01937c6e-0000-7000-8000-0000000000c1"
  }),
});
const data = await res.json();

Response200

{
  "id": "828aec20-b9c3-7700-80fb-c1e028342cc0",
  "type": "customer",
  "name": "Nadia Rahman",
  "email": "nadia@shop.northwind.example",
  "created_at": "2026-11-13T09:30:00Z",
  "session_fields": [
    {}
  ],
  "chat_ids": [
    "98c7f777-40e4-7888-8901-1999911daaaa"
  ],
  "statistics": {
    "chats_count": 3,
    "visits_count": 3
  },
  "visit": {
    "last_pages": [
      {
        "url": "https://hooks.northwind.example/mlivechat",
        "title": "Shipping",
        "opened_at": "2026-11-13T09:30:00Z"
      }
    ],
    "geolocation": {
      "city": "Kuala Lumpur"
    }
  }
}

Specifics

Method URL	`POST https://app.staging.mlive.chat/v1/agent/action/get_customer`
Who can call it	Bots, with a bot token (`mlcb_`).

Request body

application/json

idstringrequired
The customer ID.

Response

200 · application/json

OK.

idstringrequired
typestringrequired
One of customer.
namestring
emailstring
created_atstringrequired
session_fieldsarray of objectrequired
chat_idsarray of stringrequired
statisticsobjectrequired
visitobject

Errors

default