---
title: "Get all forms"
method: GET
path: "/forms"
tags: ["Forms"]
---

# Get all forms

`GET /forms`

Returns a paginated list of all forms for your organization. By default, archived (soft-deleted) forms are excluded; pass include_archived=true to include them. Use the date filters to retrieve only forms created or updated within a specific time window.

## Query parameters

- `name_like` string
- `created_before` string, date-time
- `created_after` string, date-time
- `updated_before` string, date-time
- `updated_after` string, date-time
- `include_archived` 'true' | 'false'

## Response `200`

Returns the paginated list of forms for your organization. The response includes pagination links and meta fields to navigate additional pages.

- object
  - `data` FormResource[]
    - `type` string — The type of VOMO Object
    - `id` integer — The ID of the form
    - `name` string — The name of the form
    - `form_type` 'PROJECT' | 'REGISTRATION' | 'KIOSK' | 'GIVING' — The form type. Possible values: `PROJECT` — a form attached to a specific project or serving opportunity; `REGISTRATION` — an organization-level registration or onboarding form; `KIOSK` — a self-serve check-in form used on a shared device at a volunteer site; `GIVING` — a giving or donation form.
    - `slug` string — The unique slug for the form
    - `description` string, nullable — A description for the form
    - `author_id` integer, nullable — The ID of the form author
    - `organization_id` integer, nullable — The ID of the organization the form belongs to
    - `created_at` string, date-time — The date and time the form was created at
    - `updated_at` string, date-time — The date and time the form was last updated at
    - `deleted_at` string, date-time, nullable — The date and time the form was archived at. Null if not archived.
    - `fields` FormFieldResource[] — The form fields
      - `type` string — The type of VOMO Object
      - `id` integer — The ID of the field. This is the same identifier returned as `field_id` on a form field response, so it can be used to correlate a form definition with the answers submitted against it.
      - `name` string — The name of the field
      - `description` string, nullable — The description of the field
      - `field_type` 'SHORTTEXT' | 'LONGTEXT' | 'DROPDOWN' | 'MULTIPLESELECT' | 'WAIVER' | 'TEXTSINGLE' | 'GROUP' | 'DOCUMENTUPLOAD' | 'VIRTUOUSPAYMENTS-AMOUNT' | 'VIRTUOUSPAYMENTS-DONORPAYSCOSTS' | 'VIRTUOUSPAYMENTS-RECURRING' | 'VIRTUOUSPAYMENTS-PAYMENTINFORMATION' | 'VIRTUOUSPAYMENTS-BILLINGINFORMATION' | 'VIRTUOUSPAYMENTS-NAME' | 'VIRTUOUSPAYMENTS-EMAIL' — The type of input for this field. General types: `SHORTTEXT` — single-line text answer; `LONGTEXT` — multi-line text answer; `DROPDOWN` — single selection from a list of options; `MULTIPLESELECT` — multiple selections from a list of options; `WAIVER` — a waiver or agreement the volunteer must accept; `TEXTSINGLE` — a single informational text block (no input); `GROUP` — assigns the volunteer to one or more groups; `DOCUMENTUPLOAD` — file upload field. The `VIRTUOUSPAYMENTS-*` types appear only on giving forms: `VIRTUOUSPAYMENTS-AMOUNT` — donation amount selector; `VIRTUOUSPAYMENTS-DONORPAYSCOSTS` — option for the donor to cover processing fees; `VIRTUOUSPAYMENTS-RECURRING` — recurring donation frequency selector; `VIRTUOUSPAYMENTS-PAYMENTINFORMATION` — payment card input; `VIRTUOUSPAYMENTS-BILLINGINFORMATION` — billing address input; `VIRTUOUSPAYMENTS-NAME` — donor name input; `VIRTUOUSPAYMENTS-EMAIL` — donor email input.
      - `slug` string — The unique slug for the field
      - `show_in_profile` boolean — Whether the field should appear in the user's profile
      - `options` FormFieldOptionResource[] — The field options, when applicable
        - `type` string — The type of VOMO Object
        - `id` integer — The ID of the option
        - `name` string — The display name of the option
        - `value` string — The stored value of the option
        - `enabled` boolean — Whether the option is enabled and selectable
        - `weight` integer — The sort order position of the option in its list
  - `links` PaginationLinks — Pagination navigation links returned on every paginated list response. Each URL points at the specific list endpoint being called.
    - `first` string — A link to the first page of results
    - `last` string — A link to the last page of results
    - `prev` string, nullable — A link to the previous page of results, or null on the first page
    - `next` string, nullable — A link to the next page of results, or null on the last page
  - `meta` PaginationMeta — Pagination metadata returned on every paginated list response.
    - `current_page` integer — The current page
    - `from` integer — The index of the first result on this page
    - `last_page` integer — The number of the last page of results
    - `to` integer — The index of the last result on this page
    - `path` string — The base URL of the list endpoint
    - `per_page` integer — The number of results per page
    - `total` integer — The total number of results

## Other responses

- `401` — Authentication credentials are missing or invalid.
- `429` — You have exceeded the rate limit of 30 requests per minute per API key.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/vomo/apis/vomo-api.md) · [All operations](https://skmtc.dev/vomo/apis/vomo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vomo/vomo-api/revisions/1582d52b5f1f/schema)