> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.helpyousponsor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List donor event registrations

> Requires the donor portal session in the path. Lists that donor’s organization-scoped registrations with monetary/receipt/ticket/sponsor projections and available giving next steps, plus tables hosted by the donor. Sample-linked events are excluded; hosted tables are restricted to public lifecycle statuses.



## OpenAPI

````yaml get /frontend/events/{client_id}/{session_id}
openapi: 3.0.0
info:
  title: Gratona API
  description: >-
    REST API for the Gratona fundraising platform, including donor, donation,
    sponsorship, program, event, and integration workflows. Endpoints are
    organized by tag. Most endpoints require either a Passport bearer token or
    an issued API key — see the Security Schemes section.
  contact:
    name: Gratona Engineering
    url: https://gratona.com
    email: devs@gratona.com
  version: 1.0.0
servers:
  - url: https://api.gratona.com/v1
    description: Server Version 1.0.0
security: []
tags:
  - name: Auth
    description: >-
      Login, signup, logout, password reset, and email verification for admin
      users and donors.
  - name: Donors
    description: >-
      Donor records: CRUD, profile fields, household linkage, search, filters,
      merge, and duplicate detection.
  - name: Donations
    description: >-
      Individual donation records, recurring commitments, soft credits, refunds,
      designations, and exports.
  - name: Sponsorships
    description: >-
      Donor-to-entity commitment relationships, lifecycle transitions, and
      commitment-specific filters.
  - name: Entities
    description: >-
      Recipient records (children, families, projects, animals, etc.), their
      status, and entity-level fields.
  - name: Programs
    description: >-
      Program / campaign configuration: hierarchy, settings, and program-level
      metadata.
  - name: Forms
    description: >-
      Custom form builder (HysForm), form fields, standardized donor fields, and
      field migrations.
  - name: Trips
    description: >-
      Mission-trip management: trips, participants, budgets, tasks,
      e-signatures, fundraising milestones, and background checks.
  - name: Communications
    description: >-
      Email templates, SMS, newsletters, donor email manager, and per-donor
      notes.
  - name: Payments
    description: >-
      Payment-gateway management (Stripe, PayPal, Flutterwave, QuickBooks).
      Excludes inbound webhooks — see the Webhooks tag.
  - name: Reports
    description: Dashboards, analytics, scheduled reports, and exports.
  - name: Admin
    description: >-
      Client-account administration: users, groups/permissions, settings,
      integrations, and account lifecycle.
  - name: Donor Portal
    description: >-
      Endpoints consumed by the donor-facing portal (donor login, dashboard,
      donation history, messages).
  - name: Recipient Portal
    description: Endpoints consumed by the recipient-facing portal.
  - name: Public
    description: >-
      Unauthenticated public endpoints: donor signup, public trip pages,
      peer-to-peer campaigns, public checkout.
  - name: Webhooks
    description: >-
      Inbound webhooks from third parties (Stripe, PayPal, Flutterwave, Checkr,
      DropboxSign). Annotated minimally for reference; payload shapes are owned
      by the upstream provider.
  - name: Events
    description: >-
      Event setup, invitations, registration, ticketing, attendance and event
      reporting.
  - name: Journeys
    description: >-
      Journey graphs, activation, enrollment, message templates and event
      follow-up automations.
  - name: Tasks
    description: Workspace tasks, assignments, saved task views and record collaboration.
  - name: Fundraising
    description: >-
      Fundraising portfolios, stewardship plans, giving anniversaries and
      personal donor follow-up.
  - name: Impact Stories
    description: Story intake, review, assets, consent and publication workflows.
  - name: Integrations
    description: Workspace integration connections, mappings, synchronization and recovery.
  - name: Email Calendar
    description: Connected email/calendar accounts and donor interactions.
  - name: Spaces
    description: Workspace Spaces and collaborative Pages.
  - name: Library
    description: Workspace documents, source connections, files and analysis.
  - name: Intelligence
    description: Donor intelligence and Tali workspace workflows.
  - name: Automation
    description: >-
      V3 automation primitive discovery, input validation, invocation and Zapier
      contracts.
  - name: Schema
    description: V3 model, enum, capability and scope discovery.
  - name: Zapier
    description: Zapier automation connections, polling feeds and actions.
  - name: Files
    description: Files
  - name: Client
    description: Client
  - name: Payment Gateways
    description: Payment Gateways
  - name: Email Settings
    description: Email Settings
  - name: Admin Dashboard
    description: Admin Dashboard
  - name: Recipients
    description: Recipients
  - name: Historical Archived Updates
    description: Historical Archived Updates
  - name: Team & access
    description: Team & access
  - name: Settings
    description: Settings
  - name: Notifications
    description: Notifications
  - name: Participation
    description: Participation
  - name: Users
    description: Users
  - name: Wrapped
    description: Wrapped
  - name: Donor SignUp
    description: Donor SignUp
  - name: Frontend
    description: Frontend
  - name: User
    description: User
  - name: Workspace
    description: Workspace
paths:
  /frontend/events/{client_id}/{session_id}:
    get:
      tags:
        - Events
      summary: List donor event registrations
      description: >-
        Requires the donor portal session in the path. Lists that donor’s
        organization-scoped registrations with monetary/receipt/ticket/sponsor
        projections and available giving next steps, plus tables hosted by the
        donor. Sample-linked events are excluded; hosted tables are restricted
        to public lifecycle statuses.
      operationId: PublicEventController_donorEvents
      parameters:
        - name: client_id
          in: path
          description: Record ID in the authenticated organization.
          required: true
          schema:
            type: integer
            example: 42
          example: 42
        - name: session_id
          in: path
          description: Authenticated donor portal session.
          required: true
          schema:
            type: string
            example: donor-session-token
          example: donor-session-token
      responses:
        '200':
          description: List donor event registrations completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventApiDonorEvents'
        '401':
          description: Donor session is invalid.
          content:
            application/json:
              schema:
                properties:
                  status:
                    description: Operation status.
                    type: string
                    example: error
                  message:
                    description: Authentication message.
                    type: string
                    example: Not authenticated
                  redirect:
                    description: Frontend donor login route.
                    type: string
                    example: /frontend/login/42/0
                type: object
      security: []
components:
  schemas:
    EventApiDonorEvents:
      properties:
        status:
          description: Operation status.
          type: string
          example: success
        data:
          type: array
          items:
            properties:
              id:
                description: Order ID.
                type: integer
                example: 42
              order_number:
                description: Event order number.
                type: string
                example: EVT-42-001
              status:
                description: Order status.
                type: string
                example: completed
              payment_status:
                description: Payment status.
                type: string
                example: paid
              payment_method:
                description: Payment method.
                type: string
                example: Example
                nullable: true
              gateway:
                description: Gateway identifier.
                type: string
                example: Example
                nullable: true
              currency:
                description: Currency code.
                type: string
                example: USD
              subtotal_amount:
                description: Subtotal amount.
                type: number
                example: 0
              discount_amount:
                description: Discount amount.
                type: number
                example: 0
              donation_amount:
                description: Donation amount.
                type: number
                example: 0
              fees_covered_amount:
                description: Fees covered amount.
                type: number
                example: 0
              tax_deductible_amount:
                description: Tax deductible amount.
                type: number
                example: 0
              non_deductible_amount:
                description: Non deductible amount.
                type: number
                example: 0
              total_amount:
                description: Total amount.
                type: number
                example: 0
              receipt_snapshot:
                description: Saved receipt data or an empty collection.
                type: object
                additionalProperties: true
              receipt_sent_at:
                description: Receipt time.
                type: string
                format: date-time
                example: '2026-10-20T12:00:00Z'
                nullable: true
              conversion_intents:
                description: Recorded monthly giving or child sponsorship interest.
                type: object
                additionalProperties: true
              conversion_actions:
                type: array
                items:
                  properties:
                    type:
                      description: Available next action.
                      type: string
                      enum:
                        - recurring_gift
                        - child_sponsorship
                        - additional_gift
                      example: recurring_gift
                    label:
                      description: Action label.
                      type: string
                      example: Start monthly giving
                    status:
                      description: Action availability.
                      type: string
                      enum:
                        - requested
                        - available
                        - already_gave
                      example: requested
                    url:
                      description: Frontend next-step route.
                      type: string
                      example: /frontend/donations_page/42/7
                  type: object
              event:
                properties:
                  id:
                    description: Event ID.
                    type: integer
                    example: 42
                  name:
                    description: Event name.
                    type: string
                    example: Annual Gala
                  slug:
                    description: Event slug.
                    type: string
                    example: annual-gala
                  starts_at:
                    description: Start timestamp.
                    type: string
                    format: date-time
                    example: '2026-10-20T12:00:00Z'
                    nullable: true
                  timezone:
                    description: Event timezone.
                    type: string
                    example: Africa/Kampala
                type: object
              attendees:
                type: array
                items:
                  properties:
                    id:
                      description: Guest attendee ID.
                      type: integer
                      example: 42
                    name:
                      description: Resolved guest name.
                      type: string
                      example: Example
                      nullable: true
                    status:
                      description: Attendee status.
                      type: string
                      example: registered
                    checked_in_at:
                      description: Check-in timestamp.
                      type: string
                      format: date-time
                      example: '2026-10-20T12:00:00Z'
                      nullable: true
                    ticket_type:
                      description: Ticket type name.
                      type: string
                      example: Example
                      nullable: true
                    table:
                      description: Seating table name.
                      type: string
                      example: Example
                      nullable: true
                    ticket_code:
                      description: Human-readable ticket code.
                      type: string
                      example: EVT-42-00123
                    qr_url:
                      description: QR image route when the payment is paid/free/offline.
                      type: string
                      example: Example
                      nullable: true
                    wallet_pass_url:
                      description: Wallet download route when ready.
                      type: string
                      example: Example
                      nullable: true
                    wallet_pass_status:
                      description: Wallet pass availability.
                      type: string
                      enum:
                        - inactive
                        - ready
                        - configuration_required
                        - disabled
                      example: inactive
                  type: object
              sponsors:
                type: array
                items:
                  properties:
                    id:
                      description: Sponsor ID.
                      type: integer
                      example: 42
                    company_name:
                      description: Sponsor company.
                      type: string
                      example: Example
                      nullable: true
                    status:
                      description: Sponsor status.
                      type: string
                      example: active
                    amount:
                      description: Sponsor amount.
                      type: number
                      example: 1000
                    package:
                      properties:
                        id:
                          description: Package ID.
                          type: integer
                          example: 42
                          nullable: true
                        name:
                          description: Package name.
                          type: string
                          example: Example
                          nullable: true
                        tier:
                          description: Package tier.
                          type: string
                          example: Example
                          nullable: true
                      type: object
                    deliverables:
                      type: array
                      items:
                        properties:
                          id:
                            description: Deliverable ID.
                            type: integer
                            example: 42
                          type:
                            description: Deliverable type.
                            type: string
                            example: logo
                          label:
                            description: Deliverable label.
                            type: string
                            example: Logo placement
                          status:
                            description: Deliverable state.
                            type: string
                            example: pending
                          due_at:
                            description: Due time.
                            type: string
                            format: date-time
                            example: '2026-10-20T12:00:00Z'
                            nullable: true
                          completed_at:
                            description: Completion time.
                            type: string
                            format: date-time
                            example: '2026-10-20T12:00:00Z'
                            nullable: true
                        type: object
                  type: object
              manage_url:
                description: Capability URL for this order.
                type: string
                example: Example
                nullable: true
            type: object
        hosted_tables:
          type: array
          items:
            properties:
              id:
                description: Table ID.
                type: integer
                example: 42
              name:
                description: Table name.
                type: string
                example: Table 1
              section:
                description: Table section.
                type: string
                example: Example
                nullable: true
              capacity:
                description: Maximum guests; zero means no explicit limit.
                type: integer
                example: 42
              guest_count:
                description: Non-cancelled guest count.
                type: integer
                example: 42
              checked_in_count:
                description: Checked-in guest count.
                type: integer
                example: 42
              event:
                properties:
                  id:
                    description: Event ID.
                    type: integer
                    example: 42
                  name:
                    description: Event name.
                    type: string
                    example: Annual Gala
                  slug:
                    description: Event slug.
                    type: string
                    example: annual-gala
                  starts_at:
                    description: Start timestamp.
                    type: string
                    format: date-time
                    example: '2026-10-20T12:00:00Z'
                    nullable: true
                  timezone:
                    description: Event timezone.
                    type: string
                    example: Africa/Kampala
                type: object
              manage_url:
                description: Host-console frontend URL.
                type: string
                example: /events/42/annual-gala/tables/7/host/session-token
            type: object
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.