Legal matters
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/matters/listimport requests
url = "https://win.oneshotagent.com/v1/tools/matters/list"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://win.oneshotagent.com/v1/tools/matters/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://win.oneshotagent.com/v1/tools/matters/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://win.oneshotagent.com/v1/tools/matters/list"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://win.oneshotagent.com/v1/tools/matters/list")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/matters/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyConnections
Legal matters
Read privileged legal records from connected Clio, without storing them.
POST
/
v1
/
tools
/
matters
/
list
Legal matters
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/matters/listimport requests
url = "https://win.oneshotagent.com/v1/tools/matters/list"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://win.oneshotagent.com/v1/tools/matters/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://win.oneshotagent.com/v1/tools/matters/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://win.oneshotagent.com/v1/tools/matters/list"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://win.oneshotagent.com/v1/tools/matters/list")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/matters/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyClio 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:
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
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.
{ 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 |
{ 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.
{
"connection_id": "11111111-1111-4111-8111-111111111111",
"query": "Acme",
"status": "open",
"limit": 25
}