---
title: "List form requests"
method: GET
path: "/ext/v2/form-requests/"
tags: ["Forms"]
---

# List form requests

`GET /ext/v2/form-requests/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/form-requests/`
- Auth: HTTP bearer

Returns form requests for an organization, filtered by clinic, client, patient, or appointment.

A **form request** is a client-facing form instance tied to a client and patient, optionally linked to an appointment. Forms are used to collect information from clients before or after visits — such as intake questionnaires, consent forms, or post-visit surveys.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `cursor` string, nullable: A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__gte` string, date-time, nullable: Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__lte` string, date-time, nullable: Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `clinic_id` integer, nullable: When provided, filters to form requests for the clinic with this ID.
- `clinic_client_id` integer, nullable: When provided, filters to form requests for the clinic client with this ID.
- `clinic_patient_id` integer, nullable: When provided, filters to form requests for the clinic patient with this ID.
- `appointment_id` integer, nullable: When provided, filters to form requests linked to the appointment with this ID.

## Response `200`

OK

- ExternalFormRequestSchemaList
  - `data` ExternalFormRequestSchema[], required: A single page of data contained within this list.
    - `appointment_id` integer, nullable, required: The ID of the linked appointment, if any.
    - `clinic_client_id` integer, required: The ID of the clinic client this form request belongs to.
    - `clinic_patient_id` integer, required: The ID of the clinic patient this form request belongs to.
    - `completed_at` string, date-time, nullable, required: When the client submitted the completed form.
    - `created` string, date-time, required: The datetime this object was created.
    - `dashboard_url` string, nullable, required: The client-facing dashboard URL for all pending forms for this client. Null until the form request has been sent.
    - `expires_at` string, date-time, nullable, required: When the form request expires and is no longer available.
    - `form_type` ExternalFormTypeSchema, required: Form definition metadata for a form request.
      - `client_facing_title` string, nullable, required: The client-facing title of the form.
      - `id` integer, required: The ID of the form definition.
      - `internal_name` string, required: The internal name of the form used by clinic staff.
    - `id` integer, required: The unique identifier for the form request.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `sent_at` string, date-time, nullable, required: When the form request was sent to the client.
    - `started_at` string, date-time, nullable, required: When the client first opened or began filling out the form.
    - `status` 'CREATED' | 'SENT' | 'STARTED' | 'COMPLETED' | 'EXPIRED', required: Status of a form request exposed on the Connect API.
    - `url` string, required: The client-facing URL for this individual form request.
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)