> ## Documentation Index
> Fetch the complete documentation index at: https://developers.formstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /forms

Retrieve a paginated list of forms with optional filtering and sorting

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Formstack API v2025.0",
    "version": "0.0.4"
  },
  "servers": [
    {
      "url": "https://www.formstack.com/api/v2025",
      "description": "Production server"
    },
    {
      "url": "https://staging-formstack.com/api/v2025",
      "description": "Staging server"
    },
    {
      "url": "https://dev-formstack.com/api/v2025",
      "description": "Development server"
    }
  ],
  "paths": {
    "/forms": {
      "get": {
        "tags": [
          "Forms",
          "Classic"
        ],
        "description": "Retrieve a paginated list of forms with optional filtering and sorting",
        "operationId": "getFormsList",
        "parameters": [
          {
            "name": "pageNumber",
            "in": "query",
            "description": "Page number to use when paginating through forms",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/GetFormsListApiDto/properties/pageNumber"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Number of forms to return per page",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/GetFormsListApiDto/properties/pageSize"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "Search by form name",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/GetFormsListApiDto/properties/search"
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "description": "Column to order results by",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/GetFormsListApiDto/properties/orderBy"
            }
          },
          {
            "name": "order",
            "in": "query",
            "description": "Sort direction for results (asc or desc)",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/GetFormsListApiDto/properties/order"
            }
          },
          {
            "name": "folder",
            "in": "query",
            "description": "Filter forms by folder ID",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/GetFormsListApiDto/properties/folder"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Forms list retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FormsListingApiDto"
                }
              }
            }
          },
          "404": {
            "description": "Folder not found"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "FormPreviewApiDto": {
        "title": "Form Preview",
        "description": "Form preview response",
        "properties": {
          "id": {
            "description": "The ID of the form",
            "type": "integer",
            "nullable": false
          },
          "name": {
            "description": "Name of the form",
            "type": "string",
            "nullable": false
          },
          "viewKey": {
            "description": "View key of the form",
            "type": "string",
            "nullable": false
          },
          "url": {
            "description": "URL of the live form",
            "type": "string",
            "nullable": false
          },
          "submissionsCount": {
            "description": "Count of form submissions",
            "type": "integer",
            "nullable": false
          },
          "unreadSubmissionsCount": {
            "description": "Count of unread form submissions",
            "type": "integer",
            "nullable": false
          },
          "active": {
            "description": "Whether the form is active",
            "type": "boolean",
            "nullable": false
          },
          "created": {
            "description": "Date of form creation",
            "type": "string",
            "nullable": false
          },
          "updated": {
            "description": "Date of last update",
            "type": "string",
            "nullable": false
          },
          "folder": {
            "description": "ID of the folder where the form is located",
            "type": "integer",
            "nullable": true
          },
          "db": {
            "description": "Whether submissions are saved to the database",
            "type": "boolean",
            "nullable": false
          },
          "deleted": {
            "description": "Whether the form is deleted",
            "type": "boolean",
            "nullable": false
          },
          "numberOfColumns": {
            "description": "Number of visible columns in the form",
            "type": "string",
            "nullable": false
          },
          "progressMeter": {
            "description": "Whether progress meter is enabled",
            "type": "string",
            "nullable": false
          },
          "submissions": {
            "description": "Number of submissions",
            "type": "string",
            "nullable": false
          },
          "submissionsUnread": {
            "description": "Number of unread submissions",
            "type": "string",
            "nullable": false
          },
          "views": {
            "description": "Number of form views",
            "type": "string",
            "nullable": false
          },
          "version": {
            "description": "Form version",
            "type": "string",
            "nullable": false
          },
          "language": {
            "description": "Form language",
            "type": "string",
            "nullable": false
          },
          "encrypted": {
            "description": "Whether the form is encrypted",
            "type": "boolean",
            "nullable": false
          },
          "thumbnailUrl": {
            "description": "URL to form thumbnail",
            "type": "string",
            "nullable": true
          },
          "submitButtonTitle": {
            "description": "Title of the submit button",
            "type": "string",
            "nullable": false
          },
          "inactive": {
            "description": "Whether the form is inactive",
            "type": "boolean",
            "nullable": false
          },
          "timezone": {
            "description": "Form timezone",
            "type": "string",
            "nullable": false
          },
          "shouldDisplayOneQuestionAtATime": {
            "description": "Whether the form should display one question at a time",
            "type": "boolean",
            "nullable": false
          },
          "isWorkflowForm": {
            "description": "Whether the form is a workflow form",
            "type": "boolean",
            "nullable": false
          },
          "isWorkflowPublished": {
            "description": "Whether the workflow form is published",
            "type": "boolean",
            "nullable": false
          },
          "editUrl": {
            "description": "URL to edit form",
            "type": "string",
            "nullable": false
          },
          "dataUrl": {
            "description": "URL to form data",
            "type": "string",
            "nullable": false
          },
          "summaryUrl": {
            "description": "URL to form summary",
            "type": "string",
            "nullable": false
          }
        },
        "type": "object"
      },
      "FormsListingApiDto": {
        "title": "Forms Listing",
        "description": "Forms listing response",
        "properties": {
          "page": {
            "$ref": "#/components/schemas/PaginationApiDto"
          },
          "forms": {
            "description": "Array of form previews",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormPreviewApiDto"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "GetFormsListApiDto": {
        "title": "Get Forms List",
        "description": "Get forms list params",
        "properties": {
          "pageNumber": {
            "description": "Page to use when paginating through items.",
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "pageSize": {
            "description": "Number of items to return per page.",
            "type": "integer",
            "default": 50,
            "maximum": 500,
            "minimum": 10,
            "nullable": true
          },
          "search": {
            "description": "Search by form name",
            "type": "string",
            "nullable": true
          },
          "orderBy": {
            "description": "Column to order results.",
            "type": "string",
            "nullable": true
          },
          "order": {
            "description": "Order direction of results.",
            "type": "string",
            "default": "ASC",
            "enum": [
              "ASC",
              "DESC"
            ],
            "nullable": true
          },
          "folder": {
            "description": "Forms from specified folder.",
            "type": "integer",
            "nullable": true
          }
        },
        "type": "object"
      },
      "PaginationApiDto": {
        "title": "Pagination Info",
        "description": "Pagination information",
        "properties": {
          "size": {
            "description": "The amount of records returned for this page",
            "type": "integer",
            "nullable": false
          },
          "pageNumber": {
            "description": "The current page number",
            "type": "integer",
            "nullable": false
          },
          "pageSize": {
            "description": "The actual page size",
            "type": "integer",
            "nullable": false
          },
          "totalElements": {
            "description": "The total amount of resources available",
            "type": "integer",
            "nullable": false
          },
          "totalPages": {
            "description": "The total amount of pages available, based on the pageSize",
            "type": "integer",
            "nullable": false
          }
        },
        "type": "object"
      }
    }
  },
  "tags": [
    {
      "name": "Forms",
      "description": "Forms are the core resource of the Formstack API. Use these endpoints to create, retrieve, update, copy, and delete forms, list the forms in an account with filtering and sorting, generate prefilled form URLs, and fetch the embed JavaScript or rendered HTML for a form. Most other resources—fields, submissions, emails, and submit actions—are scoped to a form."
    },
    {
      "name": "Classic",
      "description": "Classic"
    }
  ]
}
```