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

# List questionnaire categories

> The treatment areas a consultation can be started for.

Public: no bearer token is required. You can fetch the question set and build your interface before a patient signs in. Saving or submitting answers does need a token.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/users/questionnaires/categories/
openapi: 3.0.3
info:
  title: Hi-Doctor API
  version: 1.0.0
  description: >-
    Patient-facing REST API for Hi-Doctor.


    Authenticate with email and password to receive a JWT pair, then send the
    access token as `Authorization: Bearer <token>` on every subsequent request.


    Only patient-accessible endpoints are documented here. Clinician and
    back-office endpoints are intentionally omitted.
  contact:
    name: Hi-Doctor
    email: hello@hi-doctor.ai
    url: https://hi-doctor.ai
servers:
  - url: https://api.hi-doctor.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Registration, email verification, sign-in and profile.
  - name: Questionnaires
    description: Complete a consultation questionnaire and submit it for medical review.
  - name: Consultations
    description: Consultations a doctor has reviewed or is reviewing.
  - name: Prescriptions
    description: Prescriptions and reissue requests.
  - name: Billing
    description: Checkout, subscription management and the Stripe billing portal.
  - name: Records
    description: Orders, invoices and side-effect reports.
  - name: Messages
    description: The patient's private thread with their medical team.
  - name: Progress
    description: Weight, injection and note tracking. Requires an active treatment plan.
  - name: Referrals
    description: Referral summary and transactions.
paths:
  /v1/users/questionnaires/categories/:
    get:
      tags:
        - Questionnaires
      summary: List questionnaire categories
      description: >-
        The treatment areas a consultation can be started for.


        Public: no bearer token is required. You can fetch the question set and
        build your interface before a patient signs in. Saving or submitting
        answers does need a token.
      operationId: users_questionnaires_categories_list
      parameters:
        - name: ordering
          required: false
          in: query
          description: Which field to use when ordering the results.
          schema:
            type: string
        - name: limit
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - name: offset
          required: false
          in: query
          description: The initial index from which to return the results.
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedQuestionnaireCategoryList'
              example:
                count: 8
                next: null
                previous: null
                results:
                  - id: 0a1b2c3d-4e5f-4a6b-8c9d-00000000000c
                    slug: weight-loss
                    form_type: weight_loss
                    title: Weight loss
                    description: Online weight-loss assessment
                    is_enabled: true
                    active_version:
                      id: 0a1b2c3d-4e5f-4a6b-8c9d-00000000000v
                      version: 4
                      status: published
                      title: categories.weightLoss.form.title
                      schema_hash: >-
                        f2d63eb08f3966abe4cfec8b6e5b47f1be2f6fef852a870a7d88c36958a95a01
                      published_at: '2026-08-02T09:04:04.862731Z'
                      created_at: '2026-08-02T09:04:04.865432Z'
                      updated_at: '2026-08-02T09:04:04.872194Z'
                    created_at: '2026-08-02T09:04:04.855823Z'
                    updated_at: '2026-08-02T09:04:04.903259Z'
          description: ''
      security: []
components:
  schemas:
    PaginatedQuestionnaireCategoryList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/QuestionnaireCategory'
    QuestionnaireCategory:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        slug:
          type: string
          maxLength: 120
          pattern: ^[-a-zA-Z0-9_]+$
        form_type:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/FormTypeEnum'
            - $ref: '#/components/schemas/BlankEnum'
            - $ref: '#/components/schemas/NullEnum'
        title:
          type: string
          maxLength: 255
        description:
          type: string
        is_enabled:
          type: boolean
        active_version:
          allOf:
            - $ref: '#/components/schemas/QuestionnaireVersionSummary'
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - active_version
        - created_at
        - id
        - slug
        - title
        - updated_at
    FormTypeEnum:
      enum:
        - hair_growth
        - weight_loss
        - sexual_health
        - premature_ejaculation
        - chlamydia
        - urinary_tract_infection
        - emergency_contraception
        - hiv_prep
      type: string
    BlankEnum:
      enum:
        - ''
    NullEnum:
      enum:
        - null
    QuestionnaireVersionSummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        version:
          type: integer
          maximum: 2147483647
          minimum: 0
        status:
          $ref: '#/components/schemas/StatusF22Enum'
        title:
          type: string
          maxLength: 255
        schema_hash:
          type: string
          maxLength: 64
        published_at:
          type: string
          format: date-time
          nullable: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - created_at
        - id
        - updated_at
    StatusF22Enum:
      enum:
        - draft
        - published
        - archived
      type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Access token from POST /v1/users/token/

````