P
ProFormsDocs

List Templates

Browse the template gallery. Filter by category, search by name, or pull all 200+ templates at once. Templates are global — available to all accounts.

GET/api/v1/templates
ℹī¸
This endpoint is public — no authentication required. Templates are read-only resources shared across all ProForms accounts.

Query Parameters

categorystring

Filter by category slug (e.g. "business", "home-services"). Use "industry" to get all 14 industry categories at once.

searchstring

Search templates by name (case-insensitive partial match).

Example Request

List all templates
curl https://proforms.io/api/v1/templates
Filter by category
curl "https://proforms.io/api/v1/templates?category=home-services"
Search by name
curl "https://proforms.io/api/v1/templates?search=plumbing"
All industry templates
curl "https://proforms.io/api/v1/templates?category=industry"

Response

200 OK
{
  "success": true,
  "data": [
    {
      "id": "tmpl_abc123",
      "name": "Plumbing Service Request",
      "description": "Collect service details, location, and scheduling preferences",
      "category": "home-services",
      "formData": {
        "fields": [
          { "key": "name", "type": "name", "label": "Full Name", "required": true, "width": "full" },
          { "key": "phone", "type": "phone", "label": "Phone Number", "required": true, "width": "half" },
          { "key": "email", "type": "email", "label": "Email", "required": false, "width": "half" },
          { "key": "service_type", "type": "select", "label": "Service Needed", "required": true,
            "options": ["Leak Repair", "Drain Cleaning", "Water Heater", "Sewer Line", "Fixture Install", "Other"] },
          { "key": "details", "type": "textarea", "label": "Describe the Issue", "required": false }
        ],
        "settings": { ... },
        "theme": { ... }
      },
      "useCount": 42,
      "createdAt": "2026-03-09T00:00:00.000Z"
    }
  ]
}

Available Categories

See Template Categories for the full list of 20 categories covering 200+ templates.