Retrieve a session transcript

GET

https://api.jelliu.co/widget/history

GET

/widget/history

curl -G https://api.jelliu.co/widget/history \
     -H "x-widget-api-key: 3462145765a6b6c238f79a1e13e10361c24d1740ec30d27bea22dd4106c04284" \
     -H "x-widget-id: 84b5aa0e-f6d6-4d88-b3ad-cd7a5a2aeb9e" \
     -H "x-widget-parent-origin: https://www.clinicasonrisa.co" \
     -d session_id=b3e227dd-a9ea-48ce-9afe-09c21a5d8d2d \
     -d wid=84b5aa0e-f6d6-4d88-b3ad-cd7a5a2aeb9e

{
  "data": {
    "messages": [
      {
        "id": "dd16791f-33db-4eeb-bea8-c3f78f04cfe6",
        "role": "user",
        "content": "Hola, ¿tienen citas disponibles el sábado en la mañana?",
        "created_at": "2026-09-15T13:18:51.204Z"
      },
      {
        "id": "6eaab3b2-7382-4ce3-8429-9c7aaabb15ae",
        "role": "agent",
        "content": "¡Hola María! Sí, tenemos citas el sábado entre 8:00 y 12:00. ¿Qué hora te queda mejor?",
        "created_at": "2026-09-15T13:18:54.880Z"
      },
      {
        "id": "33905cc7-5022-4ba0-b376-231c0bdd7f83",
        "role": "agent",
        "content": "Hola María, soy Carolina del equipo de recepción. Ya te reservé el sábado a las 9:00.",
        "created_at": "2026-09-15T13:20:06.118Z"
      }
    ]
  }
}

Returns the last 50 messages of the session’s conversation, visitor and agent alike, oldest first. Call it after POST /widget/init returns resumed: true so the panel shows the earlier conversation instead of greeting again. Older messages are not reachable from the widget API. For live updates use GET /widget/poll.

Credentials, origin check and limits are the same as POST /widget/init. The session must belong to the widget named by the credential.

Idempotency. Read-only; safe to retry.

Access

Required scope: None; jl_ API keys are not used. The widget credential plus a matching x-widget-parent-origin authorise the call.
Rate limit: Widget public — 60 requests/min per IP, plus the widget’s rate_limit_rpm per credential and 300 requests/min per workspace; the general limiter also counts 120 requests/min per IP. See Rate limits.
Plan: Available on every plan.

Returns the last 50 messages of the session's conversation, visitor and agent alike, oldest first. Call it after `POST /widget/init` returns `resumed: true` so the panel shows the earlier conversation instead of greeting again. Older messages are not reachable from the widget API. For live updates use `GET /widget/poll`. Credentials, origin check and limits are the same as `POST /widget/init`. The session must belong to the widget named by the credential. **Idempotency.** Read-only; safe to retry. **Access** - **Required scope:** None; `jl_` API keys are not used. The widget credential plus a matching `x-widget-parent-origin` authorise the call. - **Rate limit:** Widget public — 60 requests/min per IP, plus the widget's `rate_limit_rpm` per credential and 300 requests/min per workspace; the general limiter also counts 120 requests/min per IP. See [Rate limits](/rate-limits). - **Plan:** Available on every plan.

Headers

Query parameters

widstringOptionalformat: "uuid"

Public widget id as a query parameter. Used when neither header is present.

session_idstringRequiredformat: "uuid"

Session id from POST /widget/init. Not a UUID returns 400 Invalid query.

Response

Transcript. Empty when the visitor has not sent a message yet.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

503

Service Unavailable Error