occurred_at in UTC (ISO 8601) and occurred_at_local in the account’s time zone.
Audience overview
fanaura.audience_overview returns contact totals. No parameters.
Search contacts
fanaura.search_contacts finds or ranks contacts. Each card holds the summary, identity fields, and the three newest timeline events. For the full story, call get_contact.
Map of field key to exact value, such as
{ "city": "Austin" }. Keys come from describe_contact_fields. Computed fields cannot be filtered.true to rank contacts by journey link visits. Uses limit, default 5, and ignores the other filters.Get contact
fanaura.get_contact returns one contact in full. Pass exactly one lookup.
A paragraph written from the contact’s data: who they are, when they joined, how they found you, where they were, what they told you, how to reach them, and their engagement.
Field groups. Only fields with a value appear. Each field is
{ label, value, provenance }, plus local for timestamps.Every event. See the event shape.
Contact timeline
fanaura.contact_timeline pages through a long history, 50 events at a time.
Event shape
Every detail from that moment, as
{ label, value }. Link visits include place, referring site, the app they came from, device, language, and “Visit 2 of 5”. Journey submissions include each answer.Audience activity
fanaura.audience_activity counts activity across the whole audience. It returns numbers, not people.
Describe contact fields
fanaura.describe_contact_fields lists every field Fanaura can hold, with contacts_with_value for stored fields, and every event type. Use it to answer “What can I know about my fans?” No parameters.
{ key, label, category, type, privacy, provenance, contacts_with_value }. Computed fields return contacts_with_value: null.{ type, label, sheet }. sheet: true marks the main events shown on a contact’s timeline in the Fanaura iPhone app.Field reference
- Identity
- Reach
- Location and device
- Profile
- Acquisition
- Engagement and more
Event types
The main events, shown on a contact’s timeline in the Fanaura iPhone app:
Other recorded events include
music.presave (Pre-saved a release), qr.scanned (Scanned a QR code), merch.purchased (Bought merch), capture.submitted (Submitted a capture form), fan.email_clicked (Tapped an email link), and sms.link_clicked (Tapped a text link). Call describe_contact_fields for the complete list.
Session tokens, one-time codes, and platform tokens are never returned by any tool. Read Data and privacy.

