Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Wildcard search on display number, number, description, or the client's name.",
"type": "string"
},
"status": {
"description": "open, closed or pending โ or several comma-separated, e.g. open,pending.",
"type": "string"
},
"client_id": {
"description": "Only this client's (contact id) matters.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"responsible_attorney_id": {
"description": "Only matters with this responsible attorney (user id).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"originating_attorney_id": {
"description": "Only matters with this originating attorney (user id).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"practice_area_id": {
"description": "Only matters in this practice area.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"billable": {
"description": "Only billable (true) or non-billable (false) matters.",
"type": "boolean"
},
"custom_field_id": {
"description": "Only records whose custom field with this id (from clio_list_custom_fields) matches custom_field_value.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"custom_field_value": {
"description": "The value to match. Checkbox: true or false; picklist: the option id; contact or matter field: the record id; date: YYYY-MM-DD. Text, checkbox, picklist, contact and matter fields always match exactly.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"custom_field_operator": {
"description": "Required for currency, date, time and numeric fields (= for an exact match); leave it out for every other field type.",
"type": "string",
"enum": [
"=",
"<",
">",
"<=",
">="
]
},
"updated_since": {
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z.",
"type": "string"
},
"order": {
"description": "Sort order. Default id(asc), the only order that allows unlimited cursor paging.",
"type": "string",
"enum": [
"id(asc)",
"id(desc)",
"display_number(asc)",
"display_number(desc)",
"open_date(asc)",
"open_date(desc)",
"close_date(asc)",
"close_date(desc)",
"updated_at(asc)",
"updated_at(desc)",
"created_at(asc)",
"created_at(desc)",
"client.name(asc)",
"client.name(desc)"
]
},
"fields": {
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default.",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Records per page, 1-200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page_token": {
"description": "next_page.page_token from the previous page. Omit for the first page.",
"type": "string"
},
"offset": {
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}