People

Person records

📄️ Get attendance history for a person

Returns all events a person has been checked in to (checkin_date IS NOT NULL), sorted by event start date descending, along with summary statistics including total events attended, last attendance date, and per-type attendance streaks.

📄️ Get full timeline for a person

Returns all timeline items (notes and events) for a person, filtered by the current user's permissions. Requires authentication. Notes are only included for users with Notes=1 or Admin. Plain-auth users see only non-note items (calendar events, system events). Private notes are visible only to the author and admins; Notes=1 non-admin users see their own private notes only.

📄️ Get full timeline for a family

Returns all timeline items (notes) for a family, filtered by the current user's permissions. Requires authentication. Notes are only included for users with Notes=1 or Admin. Plain-auth users see only non-note items. Private notes are visible only to the author and admins.

📄️ Get a person's uploaded photo

Returns the binary photo image. Returns 404 if no photo has been uploaded (use avatar endpoint for fallback).

📄️ Upload a person's photo (base64 encoded)

Upload a base64-encoded image file for a person. Supported formats: PNG, JPEG, JPG, GIF, WEBP. Maximum size: 10MB.

📄️ Delete a person's uploaded photo

Remove the uploaded photo for a person. This operation is idempotent and will return success even if no photo exists.

📄️ Get a person's avatar info (initials, gravatar)

Returns JSON with avatar metadata for client-side rendering. Always returns a result even if no photo is uploaded.

📄️ Get a person's full record by ID

Returns the complete person object including family info, addresses, and other related details.

📄️ Delete a person record

Permanently delete a person and all their associated records. A person who has a login can only be deleted by an administrator, never by themselves, and the last administrator cannot be deleted.

📄️ Add a person to the cart

Add a person to the current user's cart for batch operations.

📄️ Activate or deactivate a person (EditRecords role required)

Pass status=true to activate or status=false to deactivate the person. Cannot deactivate yourself.

📄️ Approve a self-registered person who is not part of a self-registered family, clearing their needs-review flag

Approve a self-registered person who is not part of a self-registered family, clearing their needs-review flag

📄️ Set a person's family role

Set a person's family role

📄️ List user-type notes for a person

Returns all notes of type 'note' for the person, filtered by visibility for the current user. Requires Notes=1 or Admin. Private notes authored by others are excluded for Notes=1 users; admins see all including private.

📄️ Create a note for a person

Creates a note on a person's record. Requires Notes=1 or Admin (via NotesRoleAuthMiddleware) plus canEditPerson() to scope writes: EditRecords/Admin may write on any person; EditSelf users only on their own family members; Notes=1-only users (no EditRecords/EditSelf) are blocked.

📄️ Get a single note by ID

Returns the note if it is visible to the current user. Admins see all notes including private. Notes=1 non-admin users see only public notes and their own private notes. Returns 404 for notes not visible to the current user (including private notes the caller cannot read — to avoid leaking note existence).

📄️ Update a note's text and/or privacy

Only the note's author or an admin may update a note.

📄️ Delete a note

Deletes the note. Requires Notes permission. Only the note's author or an admin may delete it.

📄️ Get people with no personal or work email on record

Get people with no personal or work email on record

📄️ Search persons by name or email

Search persons by name or email

📄️ List recently self-registered persons still awaiting review

Returns self-registered persons still awaiting review who are not part of a self-registered family, newest first: individuals from the public form, and people proposed for an existing family in the Member Portal (with FamilyName set).

📄️ Count self-registered families and people reviewed on their own that await review

Count self-registered families and people reviewed on their own that await review

📄️ Approve several self-registered families and people at once

Clears the needs-review flag on the listed self-registered families (and their members) and people reviewed on their own (not part of a self-registered family). Ids that are not pending self-registrations are ignored.

📄️ List all family roles

Returns all family role options (e.g. Head of Household, Spouse, Child) used when registering persons.

📄️ Find duplicate email addresses across persons and families

Find duplicate email addresses across persons and families

📄️ List the 10 most recently added persons

List the 10 most recently added persons

📄️ List the 10 most recently edited persons

List the 10 most recently edited persons

📄️ List persons with birthdays in a ±7-day window around today

List persons with birthdays in a ±7-day window around today

📄️ Get mailing email addresses grouped by classification role

Returns member email addresses for all active-family people, excluding those with the DoNotEmail property. sToEmailAddress is a system setting added by the composer, not returned here.