Clipform

List forms in workspace

Returns a paginated list of forms in the authenticated workspace. Supports filtering by live/draft status, tag names, and title search. Cursor-based pagination for efficient traversal of large form collections. Authentication: API key (`Authorization: Bearer cf_*`) or MCP OAuth.

GET
/forms

Authorization

Authorization
Required
Bearer <token>

API key (cf_*) passed as Bearer token

In: header

Query Parameters

limitinteger

Number of forms per page

Default: 25Minimum: 1Maximum: 100
cursorstring

Opaque pagination cursor from a previous response's next_cursor

tagstring

Filter by tag name(s), comma-separated. AND logic - only forms with ALL specified tags are returned.

publishedstring

Filter by live/draft status

Value in: "true" | "false"
searchstring

Case-insensitive substring search on form title

sortstring

Sort field

Default: "created_at"Value in: "created_at" | "updated_at"
orderstring

Sort order

Default: "desc"Value in: "asc" | "desc"
includestring

Comma-separated list of related resources to embed. Supported values - tags.

curl -X GET "https://api.clipform.io/v1/forms?limit=25&cursor=string&tag=string&published=true&search=string&sort=created_at&order=asc&include=string" \
  -H "Authorization: Bearer <token>"

Paginated form list

{
  "forms": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "title": "string",
      "share_id": "string",
      "is_live": true,
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "tags": [
        {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "color": "string"
        }
      ]
    }
  ],
  "next_cursor": "string"
}