Get Note Users

List the distinct users who have authored notes. Filter by case, evidence item, or linked object to see who has written notes in a particular scope — for example, to build an author picker or an activity report.

GET /v1/notes/note-users

Query parameters

All optional. With no filters, every user who has authored any note is returned.

Parameter	Type	Description
case_uuid	string	Authors of notes in this case.
evidence_uuid	string	Authors of notes linked to this evidence item.
object_id	string	Authors of notes linked to this object (see object-links.md).

Response — 200 OK

{
  "data": [
    {
      "user_id": 7,
      "email": "[e-mail]",
      "first_name": "Alex",
      "last_name": "Rivera",
      "full_name": "Alex Rivera",
      "title": "Forensic Examiner"
    },
    {
      "user_id": 12,
      "email": "[e-mail]",
      "first_name": "API",
      "last_name": "User",
      "full_name": "API User",
      "title": null
    }
  ]
}

Examples

Who has written notes in a case?

response = session.get(f"{BASE_URL}/notes/note-users", params={
    "case_uuid": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
})
for user in response.json()["data"]:
    print(f"{user['full_name']} <{user['email']}>")

Per-author note counts for a case

case_uuid = "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"

authors = session.get(f"{BASE_URL}/notes/note-users",
                      params={"case_uuid": case_uuid}).json()["data"]

for user in authors:
    notes = session.get(f"{BASE_URL}/notes", params={
        "case_uuid": case_uuid,
        "created_by_id": user["user_id"],
    }).json()
    print(f"{user['full_name']}: {notes['total']} note(s)")

Errors

Status	Body	Cause
400	{"message": "Invalid query parameters", "errors": [...]}	Empty-string filter value.
401	Unauthorized	Missing or invalid API key.