> ## 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.

> ## Agent Instructions
> Connect the Hi Doctor MCP connector at https://mcp.hi-doctor.ai/mcp. Add this URL as a remote HTTP MCP server in your client, then sign in and authorise access through OAuth. Setup: https://docs.hi-doctor.ai/mcp/connect.
>
> The REST API base is https://api.hi-doctor.ai. Hi Doctor Docs at https://docs.hi-doctor.ai/mcp searches documentation; connect to the product endpoint above for patient tools.
>
> Hi Doctor operates across the whole European Union: residents of all 27 EU member states can use the service, and every consultation is reviewed by an EU-licensed doctor. Every consultation is reviewed in full by an EU-licensed doctor, who decides on medical grounds only. No algorithm, assistant or API call approves a consultation, issues a prescription or changes a dose. The service is available in eight languages: English, Spanish, German, Dutch, Italian, French, Portuguese and Chinese.
>
> ## Rules an assistant must follow
>
> - Never invent, assume or infer a medical answer. "I don't know" is a real answer: ask the patient to pick the closest option rather than guessing for them.
> - Never give medical advice and never suggest a medication or a dose. An EU-licensed doctor decides those.
> - If a questionnaire returns `ineligible`, say so plainly. Do not retry with altered answers.
> - Before anything that costs money or cancels a plan, state exactly what will happen and get an explicit yes.
> - Cancellation takes effect at the **end of the paid period**, not immediately. Say so.
> - An early order is irreversible: it creates the renewal consultation immediately and uses up the period's one early order. Explain that and get an explicit yes.
> - Prescription and invoice links are medical documents. A `signed_redirect` link opens without signing in: give it only to the patient, never repeat it anywhere shared.
> - Send option `value`s, not the labels shown to the patient. Labels are translated, values are stable.
> - Never ask for card details. Payment happens on Stripe's hosted checkout via a link.
> - On severe or sudden symptoms (chest pain, difficulty breathing, severe allergic reaction, suicidal thoughts), stop and direct the patient to their local emergency number.

# List patient prescriptions

> Prescriptions issued to the authenticated patient, with the treatment and dosage from the originating consultation.

### Access, effects and retries
**Ownership:** Prescription belongs to patient directly or through consultation.

**Prerequisites:** An authenticated patient account is required.

**Effects:** Read only.

**Retries:** Safe read.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/users/prescriptions/
openapi: 3.0.3
info:
  title: Hi Doctor API
  version: 1.0.1
  description: >-
    The patient-facing Hi Doctor API supports account management, consultation
    questionnaires, medical documents, messages and billing. Sign-in requires
    X-Brand-Slug: hi-doctor; authenticated requests use Authorization: Bearer
    <access> with a JWT access token. See
    https://docs.hi-doctor.ai/api-reference/introduction for integration guides.
  contact:
    name: Hi Doctor
    email: hello@hi-doctor.ai
    url: https://docs.hi-doctor.ai
servers:
  - url: https://api.hi-doctor.ai
    description: Production
security: []
tags:
  - name: Account
    description: Register, verify, authenticate and manage the signed-in account.
  - name: Questionnaires
    description: Discover, save and submit consultation questionnaires.
  - name: Consultations
    description: Read consultation state and manage consultation photographs.
  - name: Prescriptions
    description: Retrieve issued prescription documents and request reissue.
  - name: Messages
    description: Read and send messages to the medical team, and download attachments.
  - name: Billing
    description: >-
      Create checkout, manage subscriptions and retrieve
      payments/invoices/credit notes.
  - name: Records
    description: Read orders and manage patient health documents.
  - name: Safety reports
    description: Submit and read suspected side-effect reports; no automated diagnosis.
  - name: Progress
    description: Record and review eligible weight-loss progress.
  - name: Referrals
    description: Read the signed-in account's referral summary and referral activity.
paths:
  /v1/users/prescriptions/:
    get:
      tags:
        - Prescriptions
      summary: List patient prescriptions
      description: >-
        Prescriptions issued to the authenticated patient, with the treatment
        and dosage from the originating consultation.


        ### Access, effects and retries

        **Ownership:** Prescription belongs to patient directly or through
        consultation.


        **Prerequisites:** An authenticated patient account is required.


        **Effects:** Read only.


        **Retries:** Safe read.
      operationId: users_prescriptions_list
      parameters:
        - name: ordering
          required: false
          in: query
          description: Which field to use when ordering the results.
          schema:
            type: string
          example: synthetic
        - name: limit
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
          example: 1
        - name: offset
          required: false
          in: query
          description: The initial index from which to return the results.
          schema:
            type: integer
          example: 1
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedUserPrescriptionList'
              examples:
                example-1:
                  summary: Illustrative response example
                  value:
                    count: 0
                    next: null
                    previous: null
                    results: []
                example-2:
                  summary: Captured response example
                  value:
                    count: 1
                    next: null
                    previous: >-
                      https://api.hi-doctor.ai/v1/users/prescriptions/?limit=1&offset=999999
                    results: []
                example-3:
                  summary: Captured response example
                  value:
                    count: 1
                    next: null
                    previous: null
                    results:
                      - brand:
                          slug: hi-doctor
                          display_name: Synthetic display name
                          primary_color: '#157a5c'
                        id: 8d3560b9-357b-50fe-b1b0-7bef4ffa703b
                        consultation_id: b0e81246-c46e-5ac2-9675-06bf07784bf4
                        adhoc_session_id: null
                        consultation_status: approved
                        shopify_order_id: null
                        treatment_id: mounjaro
                        dosage: 2.5 mg
                        prescribed_label: >-
                          Tirzepatide (Mounjaro KwikPen) solution for injection
                          · 2.5 mg
                        consultation_treatment_label: Mounjaro
                        medication_name: Tirzepatide (Mounjaro KwikPen) solution for injection
                        rx_language: es
                        dispensing_country: ESP
                        rempe_treatment_id: null
                        pdf_file: null
                        english_pdf_file: >-
                          https://api.hi-doctor.ai/v1/users/prescriptions/8d3560b9-357b-50fe-b1b0-7bef4ffa703b/pdf/english/
                        expires_at: '2026-10-15T18:33:16.401440Z'
                        collected_at: null
                        is_expired: false
                        days_to_collect: 10
                        provider: english
                        status: active
                        created_at: '2026-10-05T18:33:16.402018Z'
                        updated_at: '2026-10-05T18:33:20.457634Z'
                example-4:
                  summary: Captured response example
                  value:
                    count: 1
                    next: null
                    previous: null
                    results:
                      - brand:
                          slug: hi-doctor
                          display_name: Synthetic display name
                          primary_color: '#157a5c'
                        id: 8d3560b9-357b-50fe-b1b0-7bef4ffa703b
                        consultation_id: b0e81246-c46e-5ac2-9675-06bf07784bf4
                        adhoc_session_id: null
                        consultation_status: approved
                        shopify_order_id: null
                        treatment_id: mounjaro
                        dosage: 2.5 mg
                        prescribed_label: >-
                          Tirzepatide (Mounjaro KwikPen) solution for injection
                          · 2.5 mg
                        consultation_treatment_label: Mounjaro
                        medication_name: Tirzepatide (Mounjaro KwikPen) solution for injection
                        rx_language: es
                        dispensing_country: ESP
                        rempe_treatment_id: null
                        pdf_file: null
                        english_pdf_file: >-
                          https://api.hi-doctor.ai/v1/users/prescriptions/8d3560b9-357b-50fe-b1b0-7bef4ffa703b/pdf/english/
                        expires_at: '2026-10-15T18:33:16.401440Z'
                        collected_at: null
                        is_expired: false
                        days_to_collect: 10
                        provider: english
                        status: active
                        created_at: '2026-10-05T18:33:16.402018Z'
                        updated_at: '2026-10-05T18:33:20.457634Z'
          description: Successful list prescriptions.
        '401':
          description: >-
            No bearer token, or a token that is expired or malformed.
            Re-authenticate; do not retry the same token.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Error envelope emitted by the source branch or DRF validation.
                  `detail`, `error` and `code` depend on the branch; field
                  validation uses lists keyed by request field.
                additionalProperties: {}
              examples:
                example-1:
                  summary: Illustrative response example
                  value:
                    detail: Authentication credentials were not provided.
        '403':
          description: The account lacks permission for this operation.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Error envelope emitted by the source branch or DRF validation.
                  `detail`, `error` and `code` depend on the branch; field
                  validation uses lists keyed by request field.
                additionalProperties: {}
              examples:
                example-1:
                  summary: Illustrative response example
                  value:
                    detail: You do not have permission to perform this action.
        '429':
          description: Source-defined error response; inspect the envelope and retry rules.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
                description: >-
                  Endpoint/DRF error envelope; field validation is keyed by
                  request field.
              examples:
                example-1:
                  summary: Illustrative response example
                  value:
                    detail: Request was throttled.
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: Shell
          label: curl
          source: >
            set -eu

            umask 077

            # Path values must be URL-encoded; query string excludes the leading
            question mark.

            url="${HD_BASE_URL:?Set API
            origin}/v1/users/prescriptions/${HD_QUERY_STRING:+?${HD_QUERY_STRING}}"

            printf 'X-Brand-Slug: hi-doctor\nAccept: application/json\n' >
            "${HD_REQUEST_HEADERS_FILE:?Private header file}"

            printf 'Authorization: Bearer %s\n' "${HD_ACCESS_TOKEN:?Set backend
            JWT}" >> "$HD_REQUEST_HEADERS_FILE"

            curl --silent --show-error --max-time 30 --request GET \
              --header "@$HD_REQUEST_HEADERS_FILE" \
              --dump-header "${HD_HEADERS_FILE:?Private response header file}" \
              --output "${HD_RESPONSE_FILE:?Private response file}" \
              --write-out '%{http_code}\n%{content_type}\n' \
              "$url"
        - lang: Python
          label: requests
          source: >
            import os, json

            from pathlib import Path

            from urllib.parse import quote

            import requests

            os.umask(0o077)

            url = os.environ["HD_BASE_URL"].rstrip("/") +
            '/v1/users/prescriptions/'

            if os.environ.get("HD_QUERY_STRING"): url += "?" +
            os.environ["HD_QUERY_STRING"]

            headers = {"X-Brand-Slug": "hi-doctor", "Accept":
            'application/json'}

            headers["Authorization"] = "Bearer " + os.environ["HD_ACCESS_TOKEN"]

            kwargs = {}

            response = requests.request('GET', url, headers=headers, timeout=30,
            allow_redirects=False, **kwargs)

            Path(os.environ["HD_RESPONSE_FILE"]).write_bytes(response.content)

            Path(os.environ["HD_HEADERS_FILE"]).write_text(json.dumps(dict(response.headers)))

            print(response.status_code)

            print(response.headers.get("Content-Type", ""))
        - lang: JavaScript
          label: fetch
          source: >
            import { readFileSync, writeFileSync } from "node:fs";

            const env = process.env;

            let url = env.HD_BASE_URL.replace(/\/$/, "") +
            "/v1/users/prescriptions/";

            if (env.HD_QUERY_STRING) url += "?" + env.HD_QUERY_STRING;

            const headers = { "X-Brand-Slug": "hi-doctor", "Accept":
            "application/json" };

            headers.Authorization = "Bearer " + env.HD_ACCESS_TOKEN;

            const options = { method: "GET", headers, redirect: "manual",
            signal: AbortSignal.timeout(30000) };

            const response = await fetch(url, options);

            writeFileSync(env.HD_RESPONSE_FILE, Buffer.from(await
            response.arrayBuffer()), {mode: 0o600});

            writeFileSync(env.HD_HEADERS_FILE,
            JSON.stringify(Object.fromEntries(response.headers)), {mode:
            0o600});

            console.log(response.status);

            console.log(response.headers.get("content-type") ?? "");
components:
  schemas:
    PaginatedUserPrescriptionList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
          description: Total matching records before pagination.
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
          description: >-
            URL of the next page, or null after the last page. May be null when
            unavailable.
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
          description: >-
            URL of the previous page, or null on the first page. May be null
            when unavailable.
        results:
          type: array
          items:
            $ref: '#/components/schemas/UserPrescription'
          description: Records in this page, in the documented collection order.
    UserPrescription:
      type: object
      description: Serializer for user's prescriptions - includes consultation context.
      properties:
        brand:
          readOnly: true
          description: >-
            Brand for this user prescription. Returned by the server; not
            writable. May be null when unavailable.
          anyOf:
            - $ref: '#/components/schemas/BrandSummary'
            - enum:
                - null
              type: string
              nullable: true
        id:
          type: string
          format: uuid
          readOnly: true
          description: >-
            Unique identifier of this resource. Returned by the server; not
            writable.
        consultation_id:
          type: string
          format: uuid
          readOnly: true
          nullable: true
          description: >-
            Identifier of the related consultation. Returned by the server; not
            writable. May be null when unavailable.
        adhoc_session_id:
          type: string
          format: uuid
          nullable: true
          readOnly: true
          description: >-
            Identifier of the related adhoc session. Returned by the server; not
            writable. May be null when unavailable.
        consultation_status:
          type: string
          nullable: true
          readOnly: true
          description: >-
            Consultation status for this user prescription. Returned by the
            server; not writable. May be null when unavailable.
        shopify_order_id:
          type: integer
          nullable: true
          readOnly: true
          description: >-
            Identifier of the related order. Returned by the server; not
            writable. May be null when unavailable.
        treatment_id:
          type: string
          readOnly: true
          nullable: true
          description: >-
            Identifier of the related treatment. Returned by the server; not
            writable. May be null when unavailable.
        dosage:
          type: string
          nullable: true
          readOnly: true
          description: >-
            Dosage for this user prescription. Returned by the server; not
            writable. May be null when unavailable.
        prescribed_label:
          type: string
          readOnly: true
          description: >-
            Prescribed label for this user prescription. Returned by the server;
            not writable.
        consultation_treatment_label:
          type: string
          nullable: true
          readOnly: true
          description: >-
            Consultation treatment label for this user prescription. Returned by
            the server; not writable. May be null when unavailable.
        medication_name:
          type: string
          maxLength: 255
          description: Medication name for this user prescription. Maximum 255 characters.
        rx_language:
          type: string
          maxLength: 8
          description: Rx language for this user prescription. Maximum 8 characters.
        dispensing_country:
          type: string
          nullable: true
          maxLength: 3
          description: >-
            Dispensing country for this user prescription. May be null when
            unavailable. Maximum 3 characters.
        rempe_treatment_id:
          type: string
          nullable: true
          maxLength: 255
          description: >-
            Identifier of the related national e-prescription treatment. May be
            null when unavailable. Maximum 255 characters.
        pdf_file:
          type: string
          format: uri
          nullable: true
          readOnly: true
          description: >-
            Pdf file for this user prescription. Returned by the server; not
            writable. May be null when unavailable.
        english_pdf_file:
          type: string
          format: uri
          nullable: true
          readOnly: true
          description: >-
            English pdf file for this user prescription. Returned by the server;
            not writable. May be null when unavailable.
        expires_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Expires at timestamp in ISO 8601 format. May be null when
            unavailable.
        collected_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Collected at timestamp in ISO 8601 format. May be null when
            unavailable.
        is_expired:
          type: boolean
          readOnly: true
          description: >-
            Whether expired applies to this user prescription. Returned by the
            server; not writable.
        days_to_collect:
          type: integer
          nullable: true
          readOnly: true
          description: >-
            Days to collect for this user prescription. Returned by the server;
            not writable. May be null when unavailable.
        provider:
          allOf:
            - $ref: '#/components/schemas/Provider0ceEnum'
          description: >-
            Which prescription pipeline produced this row: `rempe` (national
            e-prescription) or `english` (English PDF).
        status:
          allOf:
            - $ref: '#/components/schemas/StatusEbdEnum'
          description: Status for this user prescription.
        created_at:
          type: string
          format: date-time
          readOnly: true
          description: >-
            Created at timestamp in ISO 8601 format. Returned by the server; not
            writable.
        updated_at:
          type: string
          format: date-time
          readOnly: true
          description: >-
            Updated at timestamp in ISO 8601 format. Returned by the server; not
            writable.
      required:
        - adhoc_session_id
        - brand
        - consultation_id
        - consultation_status
        - consultation_treatment_label
        - created_at
        - days_to_collect
        - dosage
        - english_pdf_file
        - id
        - is_expired
        - pdf_file
        - prescribed_label
        - shopify_order_id
        - treatment_id
        - updated_at
    BrandSummary:
      type: object
      properties:
        slug:
          type: string
          description: Slug for this brand summary.
        display_name:
          type: string
          description: Display name for this brand summary.
        primary_color:
          type: string
          description: Primary color for this brand summary.
      required:
        - display_name
        - primary_color
        - slug
    Provider0ceEnum:
      enum:
        - rempe
        - english
      type: string
    StatusEbdEnum:
      enum:
        - active
        - canceled
      type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.