Find elements by criteria
find_elementsFind Archicad elements by element type and property comparisons in OR-combined groups; returns GUIDs and counts with coverage warnings so you can verify query completeness.
Instructions
Find elements matching criteria groups. Groups combine with OR; inside a group the comparisons combine with logical_operator 'and' (default) or 'or'. Each group may restrict element types (is / is_not) and lists comparisons of {property, operator, value}; the schema enumerates the element types and the 22 operators, and each field documents its values and units. Call search_definitions to find a property's exact address. An element with no usable value matches no binary operator. Returns GUIDs, counts, how many elements had properties read, and 'coverage' ('whole-plan' with Tapir, 'model-elements-only' without: then 2D elements are invisible and 0 is not proof of absence). 'not_read' lists the properties nothing could read on some elements, with the reason (the official API refuses them, and Tapir 2.0.0 or newer was not there or did not answer); such a pair matches no operator, so check it before trusting a count. Property comparisons read values in the server (no API filters by property); a read spanning more than the element ceiling is refused, so narrow with element_types, story or classification first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"groups": "<groups>"
},
"name": "find_elements"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| port | No | ||
| groups | Yes | ||
| selection_only | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||