List the current user forms

Returns the current user forms, paginated by cursor. The default ordering is created_at descending; use the sort parameter to switch to another field.

Required scope: form:read.

GET /api/v1/forms

List the current user forms

cURL

curl --request GET \
  --url https://formhug.ai/api/v1/forms \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "name": "Customer feedback",
      "description": "Please share your feedback",
      "token": "Wabc12",
      "scene": "survey",
      "layout": "classic",
      "created_at": "2026-05-12T08:00:00Z",
      "updated_at": "2026-05-12T09:00:00Z",
      "last_entry_created_at": "2026-05-13T10:00:00Z",
      "entries_count": 42
    }
  ],
  "pagination": {
    "total": 123,
    "next_cursor": "NQ=="
  }
}

Authorizations

Authorization · string · header · required

Personal Access Token prefixed with fh_. Sent as Authorization: Bearer fh_xxx. The scope required by each endpoint is listed in that endpoint's description.

Query Parameters

name · string

Case-insensitive substring match against name

folder_token · string

Filter by folder; empty string means "desktop" (no folder); omit for no filter

sort · enum<string> · default: created_at

Sort field; results are always returned in descending order

Available options: created_at, updated_at, last_entry_created_at

limit · integer · default: 10

Required range: x <= 100

cursor · string

Pagination cursor returned in the previous response as pagination.next_cursor

Response

200

application/json

Success

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes