> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List form requests > 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. ## OpenAPI ````yaml get /ext/v2/form-requests/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/form-requests/: get: tags: - Forms summary: List form requests description: >- 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. operationId: form_requests_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- 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`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Ending Before - description: >- 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`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- 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. in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: >- 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. title: Cursor - description: >- 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. in: query name: modified__gte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Gte - description: >- 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. in: query name: modified__lte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Lte - description: When provided, filters to form requests for the clinic with this ID. in: query name: clinic_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, filters to form requests for the clinic with this ID. title: Clinic Id - description: >- When provided, filters to form requests for the clinic client with this ID. in: query name: clinic_client_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, filters to form requests for the clinic client with this ID. title: Clinic Client Id - description: >- When provided, filters to form requests for the clinic patient with this ID. in: query name: clinic_patient_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, filters to form requests for the clinic patient with this ID. title: Clinic Patient Id - description: >- When provided, filters to form requests linked to the appointment with this ID. in: query name: appointment_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, filters to form requests linked to the appointment with this ID. title: Appointment Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalFormRequestSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: ExternalFormRequestSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalFormRequestSchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: ExternalFormRequestSchemaList type: object ExternalFormRequestSchema: description: A form request sent or available to a clinic client. properties: appointment_id: anyOf: - type: integer - type: 'null' description: The ID of the linked appointment, if any. title: Appointment Id clinic_client_id: description: The ID of the clinic client this form request belongs to. title: Clinic Client Id type: integer clinic_patient_id: description: The ID of the clinic patient this form request belongs to. title: Clinic Patient Id type: integer completed_at: anyOf: - format: date-time type: string - type: 'null' description: When the client submitted the completed form. title: Completed At created: description: The datetime this object was created. format: date-time title: Created type: string dashboard_url: anyOf: - type: string - type: 'null' description: >- The client-facing dashboard URL for all pending forms for this client. Null until the form request has been sent. title: Dashboard Url expires_at: anyOf: - format: date-time type: string - type: 'null' description: When the form request expires and is no longer available. title: Expires At form_type: $ref: '#/components/schemas/ExternalFormTypeSchema' description: Metadata about the form definition for this request. id: description: The unique identifier for the form request. title: Id type: integer modified: description: >- The datetime this object was last modified; changes to related entities will not update this field. format: date-time title: Modified type: string sent_at: anyOf: - format: date-time type: string - type: 'null' description: When the form request was sent to the client. title: Sent At started_at: anyOf: - format: date-time type: string - type: 'null' description: When the client first opened or began filling out the form. title: Started At status: $ref: '#/components/schemas/ExternalFormRequestStatus' description: The current status of the form request. url: description: The client-facing URL for this individual form request. title: Url type: string required: - created - modified - id - clinic_client_id - clinic_patient_id - appointment_id - form_type - status - sent_at - started_at - completed_at - expires_at - url - dashboard_url title: ExternalFormRequestSchema type: object ExternalFormTypeSchema: description: Form definition metadata for a form request. properties: client_facing_title: anyOf: - type: string - type: 'null' description: The client-facing title of the form. title: Client Facing Title id: description: The ID of the form definition. title: Id type: integer internal_name: description: The internal name of the form used by clinic staff. title: Internal Name type: string required: - id - internal_name - client_facing_title title: ExternalFormTypeSchema type: object ExternalFormRequestStatus: description: Status of a form request exposed on the Connect API. enum: - CREATED - SENT - STARTED - COMPLETED - EXPIRED title: ExternalFormRequestStatus type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````