> ## 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 entity names for a program

> Returns a compact id/name list for entities in a single program. The public frontend uses this lightweight route when it needs recipient choices without the full sponsorship listing payload. The controller scopes by client id and program id, then resolves each entity display name through `Donor::getEntityName()`.



## OpenAPI

````yaml get /frontend/entities/view/{client_id}/{program_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 sponsorship relationships, lifecycle transitions, and
      sponsorship-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: Client
    description: Client
  - name: Email Settings
    description: Email Settings
  - name: Admin Dashboard
    description: Admin Dashboard
  - name: Historical Archived Updates
    description: Historical Archived Updates
  - name: Team & access
    description: Team & access
  - name: Files
    description: Files
  - name: Wrapped
    description: Wrapped
  - name: Donor SignUp
    description: Donor SignUp
  - name: Frontend
    description: Frontend
  - name: User
    description: User
paths:
  /frontend/entities/view/{client_id}/{program_id}/{session_id}:
    get:
      tags:
        - Public
      summary: List entity names for a program
      description: >-
        Returns a compact id/name list for entities in a single program. The
        public frontend uses this lightweight route when it needs recipient
        choices without the full sponsorship listing payload. The controller
        scopes by client id and program id, then resolves each entity display
        name through `Donor::getEntityName()`.
      operationId: viewFrontendEntityOptions
      parameters:
        - name: client_id
          in: path
          description: Client id that owns the entities.
          required: true
          schema:
            type: integer
          example: 207
        - name: program_id
          in: path
          description: Program id whose entities should be listed.
          required: true
          schema:
            type: integer
          example: 11
        - name: session_id
          in: path
          description: >-
            Optional frontend session id retained for route compatibility. The
            controller does not read it.
          required: true
          schema:
            type: string
          example: 7f2c8f8d64b8a1d4a9e2
      responses:
        '200':
          description: Entity id/name list.
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: array
                    items:
                      properties:
                        entity_name:
                          type: string
                          example: Jane Student
                        id:
                          type: integer
                          example: 4711
                      type: object
                type: object
      security: []

````

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