Entity-Query-vs-Instance-Query.md

+Once the internal ID of a database entry is known, there are two API endpoints available to retrieve this entity.
+
+Of course, the query endpoint would work:
+
+`POST /data/system/entity/query`
+
+```json
+{
+  "conds": {
+    "me.id": 2
+  }
+}
+```
+
+But this also does a table and result count to include in the reply, so the instance queries which do not do so will be faster.
+
+To get only the instance itself, no joined data:
+
+`GET /data/system/entity/2`
+
+Should you need joins of function calls etc:
+
+`POST /data/system/entity/2/query`
+
+```json
+{
+  "attrs": {
+    "prefetch": [
+      "module"
+    ],
+    "+select": [
+      {
+        "coalesce": "me.description,me.label"
+      }
+    ],
+    "+as": [
+      "mytext"
+    ]
+  }
+}
+```
\ No newline at end of file