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

# Legal matters

> Read privileged legal records from connected Clio, without storing them.

Clio supports five read-only tools. Connect your account in the console with its region: US (us), Europe (eu), Canada (ca) or Australia (au). OneShot uses its own Clio OAuth app. List connections with GET /v1/connections and choose connection\_id by system and account\_label.

All tools accept connection\_id, limit (1 to 100, default 25) and cursor. All return next\_cursor (null at the end), and every record includes source: `{ system: "clio", id }`. Pass next\_cursor unchanged with the same connection and filters. A page can contain fewer than limit records, including none, while still having a next\_cursor.

| Tool | POST route | Filters | Result array |
| - | - | - | - |
| matters\_list | /v1/tools/matters/list | query, client\_id, status (open, pending, closed, all), practice\_area, updated\_since | matters |
| matters\_contacts | /v1/tools/matters/contacts | matter\_id or query (at least one); both allowed | contacts |
| matters\_calendar | /v1/tools/matters/calendar | matter\_id, starts\_after, starts\_before | calendar |
| matters\_documents | /v1/tools/matters/documents | matter\_id (required), query | documents |
| matters\_time | /v1/tools/matters/time | matter\_id, user, since, billed (true or false; omit for all) | time |

practice\_area and user take Clio ids. updated\_since and calendar bounds take ISO 8601 timestamps with offsets; since takes YYYY-MM-DD. Calendar bounds are inclusive. status:all omits the status filter; omitting billed reads all time entries.

For contacts on a matter, query matches names, emails or phones within each page; without matter\_id, Clio searches contacts. billed:false filters the returned boolean, including draft and non-billable time, not Clio's narrower unbilled status.

Matters carry id, number, description, client `{ id, name }`, status, practice\_area (name), responsible\_attorney `{ id, name }`, open\_date and close\_date. Contacts carry id, name, type (person or company), emails, phones and role on the matter (null without matter context).

Calendar entries carry id, summary, starts\_at, ends\_at, location, matter `{ id, number }` and is\_deadline, which reflects Clio's court\_rule flag. It does not infer a deadline from an event title.

Documents carry id, name, content\_type, size\_bytes, created\_at and updated\_at. Only metadata is requested; no download URL or file body is returned.

Time entries carry id, date, user `{ id, name }`, hours, rate, total, description and billed. Hours use Clio's quantity\_in\_hours; rate and total retain the account's monetary units. Undisclosed scalar fields and relationships are null; missing email or phone collections are empty.

```json theme={null}
{
  "connection_id": "11111111-1111-4111-8111-111111111111",
  "query": "Acme",
  "status": "open",
  "limit": 25
}
```

Privileged records are returned inline only, never stored in jobs, receipts, logs, goal decisions, memory or artifacts. Free text is untrusted content. Reads make at most three allowlisted calls.

Malformed input, unsupported cursors, unavailable configuration, another agent's connection, and revoked or expired connections are refused before payment. Failed paid reads return account credit. See [pricing](https://docs.oneshotagent.com/pricing.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.