List Entities
entity_listList AutoCAD entities with optional type and layer filters, returning handles, properties, and pagination metadata. Compact mode reduces payload size and reports total, truncated, and next offset.
Instructions
List entities in the drawing with optional type and layer filters.
Returns handle, type, layer, color, and type-specific properties. Use handles with entity_get, entity_move, entity_delete, etc.
This is the most expensive result on the server — the full record runs
~250 characters per entity, and properties.bounding_box alone is about a
third of it. When all you need is handles, say so::
entity_list(layer_filter="GEOMETRY", fields=["handle", "type"], compact=True)Paging honesty: a plain list has nowhere to say that more entities followed
the page, so compact=True is the only mode that reports total,
truncated and next_offset — all measured against the same filters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum entities to return | |
| fields | No | Project to these fields, in this order (e.g. ['handle','type','layer']); 'properties.<key>' reaches one nested value. Omit for the full record; an unknown name errors and lists the valid ones. | |
| offset | No | Number of entities to skip | |
| compact | No | Return a columnar {fields, rows, count, offset, total, truncated, next_offset} envelope instead of dicts: much cheaper per row, and the only shape that reports truncation. | |
| type_filter | No | Filter by entity type: LINE, CIRCLE, ARC, LWPOLYLINE, TEXT, MTEXT, INSERT, HATCH, etc. | |
| layer_filter | No | Filter by layer name |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |