# List form packets

Retrieve a paginated list of form packets for the account. Supports filtering by patient, location, status, and date range. Form packets contain one or more forms assigned to a patient.

Endpoint: GET /partner/v2/account/{accountId}/location/{locationId}/form
Version: 2.0
Security: PartnerOAuth

## Query parameters:

  - `patientId` (integer)
    Filter by patient ID

  - `locationId` (integer)
    Filter by location ID

  - `status` (string)
    Filter by status (PENDING, IN_PROGRESS, COMPLETED, ARCHIVED)

  - `formTemplateId` (integer)
    Filter by form template ID

  - `startDate` (string)
    Start of date range (ISO 8601)

  - `endDate` (string)
    End of date range (ISO 8601)

  - `cursor` (string)
    Pagination cursor from previous response

  - `limit` (integer)
    Number of results per page (max 100)
    Example: 20

## Path parameters:

  - `accountId` (integer, required)
    Account identifier

  - `locationId` (integer, required)
    Location identifier

## Response 200 fields (application/json):

  - `formPackets` (array)
    List of form packets in this page

  - `formPackets.completedAt` (string)
    Completion timestamp
    Example: "2025-01-18T14:30:00-05:00"

  - `formPackets.createdAt` (string)
    Creation timestamp
    Example: "2025-01-15T10:00:00Z"

  - `formPackets.dueDate` (string)
    Due date for completion (ISO 8601)
    Example: "2025-01-20T17:00:00-05:00"

  - `formPackets.forms` (array)
    Individual forms in this packet

  - `formPackets.forms.answers` (array)
    Form answers (if requested)

  - `formPackets.forms.answers.attributeName` (string)
    Field attribute name (for mapping)
    Example: "patient_first_name"

  - `formPackets.forms.answers.fieldType` (string)
    Field type
    Enum: "TEXT", "TEXTAREA", "SELECT", "CHECKBOX", "RADIO", "DATE", "SIGNATURE", "FILE"

  - `formPackets.forms.answers.formElementId` (integer)
    Form element/field ID
    Example: 11111

  - `formPackets.forms.answers.label` (string)
    Field label
    Example: "First Name"

  - `formPackets.forms.answers.selectedOptions` (array)
    Selected options (for multi-select fields)

  - `formPackets.forms.answers.value` (string)
    Answer value
    Example: "John"

  - `formPackets.forms.completionPercentage` (integer)
    Completion percentage (0-100)
    Example: 75

  - `formPackets.forms.formTemplateId` (integer)
    Form template ID
    Example: 999

  - `formPackets.forms.formTemplateName` (string)
    Form template name
    Example: "Patient Intake Form"

  - `formPackets.forms.id` (integer)
    Unique form identifier
    Example: 54321

  - `formPackets.forms.isComplete` (boolean)
    Whether this form is complete
    Example: true

  - `formPackets.forms.mappedAnswers` (object)
    Mapped form answers by attribute name (if requested)

  - `formPackets.forms.status` (string)
    Form status
    Enum: "NOT_STARTED", "IN_PROGRESS", "COMPLETED"

  - `formPackets.id` (integer)
    Unique form packet identifier
    Example: 12345

  - `formPackets.isArchived` (boolean)
    Whether the packet is archived

  - `formPackets.isComplete` (boolean)
    Whether the packet is complete

  - `formPackets.locationId` (integer)
    Location ID
    Example: 111

  - `formPackets.locationName` (string)
    Location name
    Example: "Main Street Clinic"

  - `formPackets.patientId` (integer)
    Patient ID
    Example: 67890

  - `formPackets.patientName` (string)
    Patient name
    Example: "John Doe"

  - `formPackets.patientUrl` (string)
    Patient-facing URL to complete forms

  - `formPackets.staffUrl` (string)
    Staff-facing URL to view/edit forms

  - `formPackets.status` (string)
    Form packet status
    Enum: "PENDING", "IN_PROGRESS", "COMPLETED", "ARCHIVED"

  - `formPackets.updatedAt` (string)
    Last update timestamp
    Example: "2025-01-18T14:30:00Z"

  - `nextCursor` (string)
    Opaque cursor for fetching the next page. Null if no more results.


## Response 400 fields

## Response 401 fields

## Response 403 fields