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

# List Routing Forms

> List the routing forms in a workspace with the Zeeg API, returning paginated results that carry each form's name, slug, public URL, and status.

Returns a paginated list of the routing forms in your workspace, newest first.

Each entry carries the routing form itself. The questions and the routes ship from [Get a Routing Form](/api/routing-forms/get-a-routing-form).

<Note>
  `url` is the public address at which an invitee opens the routing form. `slug` is the last segment of that address.
</Note>


## OpenAPI

````yaml GET /routing-forms
openapi: 3.0.0
info:
  title: Zeeg Public API
  description: >-
    Zeeg public API documentation.


    ## Authentication

    All endpoints require a Bearer token. You can generate an API token from
    [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access).


    Each token is scoped to specific permissions (e.g. `events:read`,
    `webhooks:write`). Make sure your token has the required scopes for the
    endpoints you want to use.


    ## Recommended Headers

    We recommend including the `Accept: application/json` header in all API
    requests to ensure you receive JSON responses.
  version: 2.0.0
  x-logo:
    url: https://app.zeeg.me/img/logo-dark.2ca83593.svg
    backgroundColor: '#f7f7f9'
    altText: zeeg
  contact:
    name: Zeeg Support
    email: support@zeeg.me
    url: https://zeeg.me/en/contact
  license:
    name: Proprietary
    url: https://zeeg.me/en/legal/terms
  termsOfService: https://zeeg.me/en/legal/terms
servers:
  - url: https://api.zeeg.me/v2
    description: Production
security:
  - bearer: []
tags:
  - name: Scheduled Events
    description: Management of events scheduled via Zeeg
  - name: Scheduling Pages
    description: Scheduling pages information and management
  - name: Availability Schedule
    description: Read and change availability for users
  - name: Webhooks
    description: Webhooks management
  - name: Notes
    description: Notes for scheduled events
  - name: Workspaces & Teams
    description: Workspace users and team member management
  - name: AI Agent
    description: AI Agent integration endpoints
  - name: Payloads
    description: Webhook payload schemas
  - name: CRM - Objects
    description: >-
      Discover the schema of CRM objects (standard and custom) including all
      attribute definitions
  - name: CRM - Companies
    description: Create, read, update, and delete CRM company records
  - name: CRM - People
    description: Create, read, update, and delete CRM person records
  - name: Routing Forms - Forms
    description: Read routing forms with their questions and their routes
  - name: Routing Forms - Submissions
    description: Read and delete the submissions that invitees send through a routing form
paths:
  /routing-forms:
    get:
      tags:
        - Routing Forms - Forms
      summary: List routing forms
      description: >-
        Returns a paginated list of the routing forms in your workspace, newest
        first.


        Each entry carries the routing form itself. To read the questions and
        the routes of one routing form, call `GET /routing-forms/{id}`.


        **Required scope:** `routing_forms:read` or `routing_forms:write`
      operationId: get-routing-forms
      parameters:
        - schema:
            type: integer
            default: 1
            minimum: 1
          in: query
          name: page
          description: Page number.
        - name: count
          in: query
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 100
          description: Number of routing forms per page.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  status:
                    type: integer
                    example: 200
                  data:
                    type: object
                    properties:
                      pagination:
                        $ref: '#/components/schemas/Pagination'
                      routingForms:
                        type: array
                        items:
                          $ref: '#/components/schemas/RoutingForm'
              examples:
                Success:
                  value:
                    success: true
                    status: 200
                    data:
                      pagination:
                        totalItems: 1
                        perPage: 20
                        currentPage: 1
                        lastPage: 1
                        hasPreviousPage: false
                        hasNextPage: false
                      routingForms:
                        - id: f1cbafc4-b646-4cf9-af29-193491b555d9
                          name: Inbound Lead Qualification
                          slug: inbound-lead-qual
                          url: https://zeeg.me/RF/inbound-lead-qual
                          isActive: true
                          headline: Tell us about your team
                          body: null
                          submitBtnText: Continue
                          styleSettings:
                            bgColor: '#ffffff'
                            buttonBgColor: '#1f2937'
                            buttonTextColor: '#ffffff'
                          createdAt: '2026-04-01T09:12:44+00:00'
                          updatedAt: '2026-04-10T08:30:00+00:00'
        '401':
          $ref: '#/components/responses/401'
        '403':
          description: >-
            Forbidden — the token misses the scope, or the user may not read
            routing forms
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      error:
                        type: object
                        properties:
                          type:
                            type: string
                          message:
                            type: string
                          error_id:
                            type: string
                          required_scopes:
                            type: array
                            items:
                              type: string
                  - type: object
                    properties:
                      success:
                        type: boolean
                      message:
                        type: string
                      status:
                        type: integer
              examples:
                Missing scope:
                  value:
                    error:
                      type: insufficient_scope
                      message: >-
                        Your token is missing the required scope(s). Include at
                        least one of: routing_forms:read, routing_forms:write.
                      error_id: 6f0a2d31-9c4e-4a80-8f2b-1d5c7e9a4b03
                      required_scopes:
                        - routing_forms:read
                        - routing_forms:write
                No permission:
                  value:
                    success: false
                    message: You don't have permission to view routing forms.
                    status: 403
        '422':
          $ref: '#/components/responses/422'
      security:
        - bearer: []
components:
  schemas:
    Pagination:
      type: object
      description: The page counters that a paginated list response carries.
      properties:
        totalItems:
          type: integer
          description: Number of items that match the request across every page.
          example: 42
        perPage:
          type: integer
          description: Number of items on one page.
          example: 20
        currentPage:
          type: integer
          description: Number of the page in this response.
          example: 1
        lastPage:
          type: integer
          description: Number of the last page.
          example: 3
        hasPreviousPage:
          type: boolean
          description: True when a page comes before this one.
          example: false
        hasNextPage:
          type: boolean
          description: True when a page comes after this one.
          example: true
    RoutingForm:
      type: object
      description: >-
        A routing form, as returned by the list endpoint. The questions and the
        routes ship from the detail endpoint only.
      properties:
        id:
          type: string
          format: uuid
          example: f1cbafc4-b646-4cf9-af29-193491b555d9
        name:
          type: string
          description: The internal name of the routing form.
          example: Inbound Lead Qualification
        slug:
          type: string
          description: The slug that addresses the routing form in its public URL.
          example: inbound-lead-qual
        url:
          type: string
          format: uri
          description: The public address at which an invitee opens the routing form.
          example: https://zeeg.me/RF/inbound-lead-qual
        isActive:
          type: boolean
          description: An inactive routing form accepts no submission.
          example: true
        headline:
          type: string
          nullable: true
          description: The headline that the routing form shows above the questions.
          example: Tell us about your team
        body:
          type: string
          nullable: true
          description: The body text that the routing form shows below the headline.
          example: null
        submitBtnText:
          type: string
          nullable: true
          description: The label on the submit button of the routing form.
          example: Continue
        styleSettings:
          $ref: '#/components/schemas/RoutingFormStyleSettings'
        createdAt:
          type: string
          format: date-time
          nullable: true
          description: Time at which the routing form was created, in UTC.
          example: '2026-04-01T09:12:44+00:00'
        updatedAt:
          type: string
          format: date-time
          nullable: true
          description: Time of the last change to the routing form, in UTC.
          example: '2026-04-10T08:30:00+00:00'
    RoutingFormStyleSettings:
      type: object
      description: >-
        The colours of the public routing form page. Each value is a CSS colour
        of at most 20 characters, or `null` when the routing form sets no
        colour. A response always carries the object with all three keys. The
        write endpoints accept the same shape, so a routing form that you read
        goes straight back to `PATCH /routing-forms/{id}` without reshaping.
      properties:
        bgColor:
          type: string
          nullable: true
          maxLength: 20
          description: Background colour of the page.
          example: '#ffffff'
        buttonBgColor:
          type: string
          nullable: true
          maxLength: 20
          description: Background colour of the submit button.
          example: '#1f2937'
        buttonTextColor:
          type: string
          nullable: true
          maxLength: 20
          description: Text colour of the submit button.
          example: '#ffffff'
  responses:
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
          examples:
            Unauthenticated:
              value:
                message: Unauthenticated.
    '422':
      description: Unprocessable Entity
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: The given data was invalid.
              errors:
                type: object
                additionalProperties:
                  type: array
                  items:
                    type: string
                example:
                  field_name:
                    - The field_name field is required.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: ''

````