get_relationship_ledger

​

When to use it

• “Show me every event anyone from these 30 target accounts has been to.”
• “Which of these people actually checked in, and where?”
• “Give me the LA dinner roster as a CSV with partner source and city.”
• “Who from Wavecrest has registered for anything this quarter?”

​

Parameters

​

Response

• attended is a checked-in sign-up. registered is an RSVP, never attendance.
• no_show appears only for a held event whose source recorded check-in. Where check-in was not recorded the sign-up reads registered with a partial_coverage gap.
• An event not yet held reads registered with a gap.
• seniority is advisory, from the title, and used by no rule or count.
• A null partner_source does not mean no partner brought the person.

{
  "tool": "get_relationship_ledger",
  "data": [
    {
      "row_count": 1,
      "total_matching": 7,
      "counts_by_status": {
        "invited": 0, "registered": 7, "declined": 0, "cancelled": 0,
        "attended": 0, "no_show": 0, "unknown": 0
      },
      "rows": [
        {
          "email": "luis.castillo@wavecrestgames.com",
          "company_domain": "wavecrestgames.com",
          "company": "Wavecrest Games",
          "name": "Luis Castillo",
          "title": "Head of Partnerships",
          "seniority": "executive",
          "channel_id": "cmvifxr72000e07l2oj1h2be8",
          "event_name": "ScaleUp.ai x Marlowe Cloud: LA Revenue Leaders Dinner",
          "event_start": "2026-11-19T02:30:00",
          "event_city": "Los Angeles-Long Beach-Anaheim, CA",
          "status": "registered",
          "invited_at": null,
          "registered_at": "2026-10-15T23:00:00.000Z",
          "checked_in_at": null,
          "partner_source": null,
          "known_by": ["ben@heybtw.com"],
          "person_city": "Pasadena",
          "as_of": "2026-10-21T18:24:54.916Z",
          "via": "heybtw"
        }
      ]
    }
  ],
  "metadata": {
    "pagination": { "limit": 1, "returned": 1, "has_more": true, "next_cursor": "v1.eyJ..." }
  },
  "gaps": [
    {
      "code": "partial_coverage",
      "message": "Event field not recorded: status",
      "what_to_do": "Treat registered on those events as an RSVP, not attendance. Retrying will not change the result until the event is held.",
      "retryable": false
    }
  ],
  "status": "partial"
}

​

Rules the agent must follow

• Registered is not attended. Only attended (checked in) means the person came.
• Null is unknown, never zero.
• Nothing here is a ranking or engagement metric. Do not grade people from it.
• Page with next_cursor on the same filters; do not fan out per-event get_event_details calls instead.
• No row reads cancelled today, because no store records a cancelled registration.

​

Errors and gaps

• invalid_parameter: none of domains, emails and channel_id was given, or a filter, limit or cursor is malformed.
• partial_coverage gap: an event not yet held, or check-in not recorded. Not retryable. Disclose it.
• entitlement_required: the plan lacks MCP read.
• internal_error: retry once.

​

Related

• get_account_relationship: one account, contacts collapsed to their most recent event.
• get_event_details: one event’s roster and attendance mix.
• check_people: what the workspace knows per email, before an import.
• Playbook: Did anyone follow up, and what did the event do for pipeline.