---
title: "Start a group visit. Creates a synthetic ScheduleItem + Appointment bound to the
group, returning the appointment ID for the caller to navigate to."
method: POST
path: "/GroupVisits/start"
tags: ["GroupVisits"]
---

# Start a group visit. Creates a synthetic ScheduleItem + Appointment bound to the
group, returning the appointment ID for the caller to navigate to.

`POST /GroupVisits/start`

## Request body

- StartGroupVisitRequest
  - `patientGroupId` string
  - `locationId` string, nullable
  - `reasonForVisit` string, nullable

## Response `200`

OK

- GroupVisitDto
  - `appointmentId` string
  - `patientGroupId` string
  - `groupName` string
  - `groupType` string
  - `startedAt` string, date-time
  - `status` string
  - `reasonForVisit` string, nullable
  - `soapNotes` GroupSoapNoteDto[]
    - `id` string
    - `subjective` string
    - `objective` string
    - `assessment` string
    - `plan` string
    - `cohortLabel` string, nullable
    - `status` string
    - `format` string — Note-format discriminator (PAW-744). A group visit's AI-generated note comes from the same generation path as a patient visit's, so it inherits the appointment type's note format — including single-section formats, whose whole body lives in `Subjective`. The editor needs this to avoid labelling that body "Subjective" beside three empty boxes.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `exceptions` MemberExceptionDto[]
      - `id` string
      - `soapNoteId` string
      - `patientGroupMemberId` string
      - `memberDisplayName` string
      - `exceptionNote` string
      - `differentTreatment` boolean
      - `followUpNeeded` boolean
      - `createdAt` string, date-time
  - `treatments` GroupTreatmentDto[]
    - `id` string
    - `productName` string
    - `dose` string, nullable
    - `route` string, nullable
    - `frequency` string, nullable
    - `duration` string, nullable
    - `numberTreated` union
      - integer
      - string, int32
    - `cohortLabel` string, nullable
    - `inventoryItemId` string, nullable
    - `serviceCatalogItemId` string, nullable
    - `quantityUsed` union
      - number, double
      - string, double
    - `inventoryTransactionId` string, nullable
    - `meatWithdrawalEndDate` string, date, nullable
    - `milkWithdrawalEndDate` string, date, nullable
    - `notes` string, nullable
    - `createdById` string
    - `createdAt` string, date-time
  - `activeWithdrawals` ActiveWithdrawalDto[]
    - `productName` string
    - `kind` string — "meat" or "milk"
    - `endDate` string, date
    - `treatmentId` string

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/a905bde4e796/schema)