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

# List Form Templates

> Retrieve a paginated list of form templates available in the authorized workspaces.

Retrieve all active form templates available in the authorized workspaces.

<Info>
  Only **enabled** and **published** templates are returned by this endpoint. Archived or disabled templates require the `?archived=true` query parameter.
</Info>

<Tip>
  Cache template information to improve performance. Template configurations don't change frequently, so you can refresh this data periodically (e.g., hourly or daily).
</Tip>

<Warning>
  Template slugs can be reused across different workspaces. Always combine the template slug with the workspace slug when storing or referencing templates in your system.
</Warning>


## OpenAPI

````yaml GET /form_templates
openapi: 3.0.0
info:
  title: Penbox API
  version: '1.0'
  description: >-
    The Penbox API provides programmatic access to Penbox's form management,
    case management, and document processing capabilities. Authenticate using
    Bearer tokens created at https://app.penbox.io/workspace/settings/api
servers:
  - url: https://connect.penbox.io/v1
    description: Production
  - url: https://connect.aiboov.com/v1
    description: Staging
security:
  - BearerAuth: []
paths:
  /form_templates:
    get:
      summary: List Form Templates
      description: >-
        Retrieve a paginated list of form templates available in the authorized
        workspaces.
      operationId: list-form_templates
      parameters:
        - name: archived
          in: query
          description: Include archived form templates when true
          schema:
            type: boolean
            default: false
        - $ref: '#/components/parameters/PageNumber'
        - $ref: '#/components/parameters/PageSize'
        - name: sort
          in: query
          description: >-
            Sort field (prefix with - for descending). Allowed values:
            created_at, updated_at
          schema:
            type: string
            enum:
              - +created_at
              - '-created_at'
              - +updated_at
              - '-updated_at'
            default: '-created_at'
          example: '-created_at'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      total_count:
                        type: integer
                        description: Total number of form templates
                      total_pages:
                        type: integer
                        description: Total number of pages
                      page_size:
                        type: integer
                        description: Number of items per page
                      current_page:
                        type: integer
                        description: Current page number
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Form template customization UUID
                        created_at:
                          type: string
                          format: date-time
                          description: Creation timestamp
                        slug:
                          type: string
                          description: Form template slug identifier
                        name:
                          type: string
                          description: Form template name (customization or template name)
                        archived_at:
                          type: string
                          format: date-time
                          nullable: true
                          description: Timestamp when archived
                        enabled:
                          type: boolean
                          description: Whether the form template is enabled
components:
  parameters:
    PageNumber:
      name: page[number]
      in: query
      description: Page number (starts at 1)
      schema:
        type: integer
        default: 1
        minimum: 1
    PageSize:
      name: page[size]
      in: query
      description: 'Number of items per page (max: 100)'
      schema:
        type: integer
        default: 10
        maximum: 100
        minimum: 1
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: token
      description: >-
        API token (starts with pnbx_). Create at
        https://app.penbox.io/workspace/settings/api. Include as: Authorization:
        Bearer {token}

````