> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read who from support can see your data

> Whether MITHUNAI support may open a session, who is inside now, and who has been. A support session cannot read this: the record of the access belongs to you.

Whether MITHUNAI support may open a session against your organisation, which sessions are live right now, and which have been. Requires the owner or administrator role; see [Support access](/administration/support-access) for what a session can and cannot read.

Support access is **off until you turn it on**. While it is off, your organisation is not visible to support at all: an attempt to open a session against it is refused as though the organisation did not exist.

A live support session cannot read this endpoint. The record of support's access to your data belongs to you, not to the party doing the accessing.

## Response

<ResponseField name="allowed" type="boolean" required>
  Whether MITHUNAI support may open a session. `false` until an owner or administrator turns it on.
</ResponseField>

<ResponseField name="active" type="object[]" required>
  Sessions inside the organisation right now. Empty when nobody is.

  <Expandable title="session">
    <ResponseField name="id" type="string" required>
      The session id.
    </ResponseField>

    <ResponseField name="staff_name" type="string" required>
      The staff member's name, captured when the session opened.
    </ResponseField>

    <ResponseField name="staff_email" type="string" required>
      The staff member's email, captured when the session opened.
    </ResponseField>

    <ResponseField name="reason" type="string" required>
      The reason they gave for opening it.
    </ResponseField>

    <ResponseField name="started_at" type="string" required>
      When the session opened, ISO 8601 in UTC.
    </ResponseField>

    <ResponseField name="expires_at" type="string" required>
      When the session stops, or stopped, ISO 8601 in UTC.
    </ResponseField>

    <ResponseField name="end" type="string | null" required>
      Why it stopped. `null` while it is live.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="history" type="object[]" required>
  Recent sessions, live and finished, newest first. Same fields as `active`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl "$MITHUNAI_URL/arukz/api/v1/support-access" \
    --header "Authorization: Bearer $MITHUNAI_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import os

  import requests

  response = requests.get(
      f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/support-access",
      headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
      timeout=30,
  )
  response.raise_for_status()
  state = response.json()
  if state["active"]:
      print(f"{len(state['active'])} support session(s) live right now")
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  // From your backend. Never send an API key to a browser.
  const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/support-access`, {
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  })
  const state = await response.json()
  console.log(state.allowed, state.active.length)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "allowed": true,
    "active": [
      {
        "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
        "staff_name": "Priya Raman",
        "staff_email": "priya.raman@mithunai.com",
        "reason": "Ticket 4821: ingestion reports success but the assistant abstains",
        "started_at": "2026-09-26T09:14:02.118374+00:00",
        "expires_at": "2026-09-26T10:14:02.118374+00:00",
        "end": null
      }
    ],
    "history": [
      {
        "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
        "staff_name": "Priya Raman",
        "staff_email": "priya.raman@mithunai.com",
        "reason": "Ticket 4821: ingestion reports success but the assistant abstains",
        "started_at": "2026-09-26T09:14:02.118374+00:00",
        "expires_at": "2026-09-26T10:14:02.118374+00:00",
        "end": null
      },
      {
        "id": "3f2a1c9e-8b4d-4e6f-9a1b-2c3d4e5f6a7b",
        "staff_name": "Priya Raman",
        "staff_email": "priya.raman@mithunai.com",
        "reason": "Ticket 4713: widget returns 400 on every question",
        "started_at": "2026-09-19T11:02:44.901233+00:00",
        "expires_at": "2026-09-19T12:02:44.901233+00:00",
        "end": "expired"
      }
    ]
  }
  ```

  ```json 401 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "authentication_error", "message": "Authentication is required." }
  ```

  ```json 403 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "authorization_error", "message": "You are not allowed to perform this action." }
  ```
</ResponseExample>