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

# Analytics Day Conversations

> The conversations behind one day on the insights chart — every thread with a message on that calendar day, newest first, with per-day send/reply counts and a Unibox deep link. Tuco AI iMessage API, bearer-token auth.

<Note>
  The drill-down for one bar of the [insights](/api-reference/endpoint/analytics-insights) volume chart. Returns every conversation that had at least one message on `date` (cut in the workspace timezone), ordered by most recent activity, with a link straight to the [Unibox](https://app.tuco.ai/unibox) thread.

  Up to 60 conversations are returned; `total` reports how many were active in full.
</Note>

## Authentication

```bash theme={null}
Authorization: Bearer tuco_sk_xxxxxxxxxxxxx
```

## Query parameters

<ParamField query="date" type="string" required>The calendar day to drill into, `YYYY-MM-DD`, cut in the workspace timezone. Returns `400` if missing or malformed.</ParamField>
<ParamField query="lineId" type="string">Restrict to conversations on a single Tuco line (24-char ObjectId hex).</ParamField>
<ParamField query="timezone" type="string">IANA zone the day is cut in (e.g. `America/New_York`). Defaults to the workspace timezone. `tz` is accepted as an alias.</ParamField>

***

## Example

<CodeGroup>
  ```bash Threads active on Aug 15 theme={null}
  curl "https://app.tuco.ai/api/analytics/conversations?date=2026-08-15" \
    -H "Authorization: Bearer tuco_sk_xxxxxxxxxxxxx"
  ```
</CodeGroup>

## Success response (200)

```json theme={null}
{
  "success": true,
  "date": "2026-08-15",
  "timezone": "America/New_York",
  "total": 59,
  "returned": 59,
  "conversations": [
    {
      "name": "Jasun Liepitz",
      "phone": "+16183034210",
      "leadId": "6a82fbf0586005e0ca405c37",
      "sent": 3,
      "replied": 2,
      "lastMessage": "Sounds good, let's set up a time to talk.",
      "lastDirection": "in",
      "lastAt": "2026-08-15T18:22:41.000Z",
      "uniboxHref": "/unibox?conversation=%2B16183034210"
    }
  ]
}
```

<ResponseField name="date" type="string">The calendar day the results were cut for, echoed back as `YYYY-MM-DD`.</ResponseField>
<ResponseField name="timezone" type="string">IANA zone the day was cut in — the resolved `timezone`/`tz` param, or the workspace default.</ResponseField>
<ResponseField name="total" type="number">Distinct conversations active on the day (before the 60-row cap).</ResponseField>
<ResponseField name="returned" type="number">How many conversations are in this response (capped at 60).</ResponseField>
<ResponseField name="conversations[].sent" type="number">Outbound messages to this conversation on that day.</ResponseField>
<ResponseField name="conversations[].replied" type="number">Inbound messages from this conversation on that day.</ResponseField>
<ResponseField name="conversations[].lastDirection" type="string">`in` if the day's last message was inbound, `out` if outbound.</ResponseField>
<ResponseField name="conversations[].uniboxHref" type="string">Relative link that opens this thread in Unibox. The conversation id is the E.164 phone.</ResponseField>

***

## Error responses

| Status | When                               |
| ------ | ---------------------------------- |
| `400`  | `date` missing or not `YYYY-MM-DD` |
| `401`  | Missing or invalid API key         |
| `500`  | Server error loading conversations |