Create report
POST/reports
Create detailed feedback or report issues directly related to specific API interactions.
Request
Responses
- 200
The created report id, to be referenced when emailing support.
Operation spec
{
"method": "post",
"path": "/reports",
"operationId": "create-report",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "Input of the report.",
"properties": {
"rating": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"description": "Optional rating for the output of the given response: from very bad (1) to perfect (5)."
},
"feedback": {
"type": "string",
"description": "Feedback on the given response. This should typically explain the rating, suggest specific improvements or highlight the good points."
},
"reply_to": {
"type": "string",
"format": "email",
"description": "Optional email address for Nabla to contact for additional information or clarification regarding the submitted report feedback."
},
"payload": {
"description": "Input and output of the related API call.",
"oneOf": [
{
"title": "GENERATE_NOTE",
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"type": "string",
"enum": [
"GENERATE_NOTE"
],
"description": "The report is about a call to the [Generate Note](/core-api/reference/next/server/generate-note) endpoint (or its async version)."
},
"input": {
"type": "object",
"description": "Input for note generation.",
"properties": {
"note_locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"transcript_items": {
"type": "array",
"description": "The transcript from which to generate the note.\n\nYou don't need to specify each item's start or end time, but make sure they are sorted. In fact, due to its asynchronous nature, our [real-time transcription API](/core-api/reference/next/server/transcribe-ws) does not guarantee its results order. Thus, before calling this note-generation API please **filter-out non-final items and sort them by `start_offset_ms`**.",
"items": {
"type": "object",
"description": "A portion of the transcribed consultation.",
"properties": {
"text": {
"type": "string",
"description": "The transcribed text.",
"example": "Also, I’m allergic to peanuts."
},
"speaker_type": {
"type": "string",
"enum": [
"DOCTOR",
"PATIENT",
"UNSPECIFIED"
],
"description": "Who said the text in this transcript item.",
"example": "DOCTOR",
"title": "speaker"
}
},
"required": [
"text",
"speaker_type"
],
"title": "transcript_item_request"
}
},
"note_template_key": {
"type": "string",
"description": "Human-readable identifier for the note template to use for generation. Use [List note templates](/core-api/reference/next/server/list-generate-note-templates) to get available keys."
},
"note_sections_customization": {
"type": "array",
"items": {
"type": "object",
"properties": {
"section_key": {
"type": "string",
"title": "note_section_key",
"description": "Key of the note section this customization should apply to.",
"example": "CHIEF_COMPLAINT"
},
"custom_instruction": {
"type": "string",
"maxLength": 700,
"example": "Include discussion about first symptoms",
"description": "Allow to customize a note section by providing specific guidelines. These guidelines must be as clear and concise as possible for best results.",
"title": "note_section_customization_custom_instruction"
},
"style": {
"type": "string",
"enum": [
"AUTO",
"PARAGRAPH",
"BULLET_POINTS"
],
"example": "PARAGRAPH",
"description": "Specifies the desired style for the note section:\n\n • `PARAGRAPH`: Prioritizes generating paragraphs;\n\n • `BULLET_POINTS`: Prioritizes structuring content using bullet points.\n\n • `AUTO`: Automatically picks the most natural formatting option.\n\nDefault is `AUTO`.",
"title": "note_section_customization_section_style"
},
"level_of_detail": {
"type": "string",
"enum": [
"DEFAULT",
"DETAILED"
],
"description": "Specifies the desired level of details. Use `detailed` to get more details in the note section.",
"title": "note_section_customization_level_of_detail"
},
"split_by_problem": {
"type": "boolean",
"description": "Flag to structure the content of the note sections according to distinct clinical problems or topics addressed during the consultation."
}
},
"required": [
"section_key"
],
"title": "note_section_customization_request"
},
"description": "Advanced per-section customization options for the chosen template.\n\nYou should **only specify sections that belong to the given template**, and **only specify customization options that are supported for the given section**. Also, only specify sections you want to customize, no need to be exhaustive.\n\n\nCheck [Note templates sections](/next/core-api/guides/note-templates/note-customization) for compatibility matrix."
},
"note_template_custom_instructions": {
"type": "string",
"nullable": true,
"maxLength": 700,
"description": "Optional note-level (template-level) guidelines applied across the whole note for this template.",
"example": "Prefer concise bullet-style phrasing throughout the note."
},
"current_note": {
"description": "Optional note from a previous transcription session, to be updated using the new `transcript_items`. This is useful if you generate notes gradually to avoid accumulating a very long transcript items list.\nThe `template` and `locale` fields describe the note being passed in and do not control the output.",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
},
"unstructured_context": {
"type": "string",
"description": "Some unstructured contextual information that will be used to generate the note (for example name, gender, age, pronouns, medical history). For better information processing, please prioritize passing information in a structured manner via the `structured_context` field. Generating the note will take longer if you pass a long `unstructured_context`.",
"maxLength": 10000
},
"structured_context": {
"type": "object",
"description": "Structured context about the patient and the encounter, which will be taken into account when generating the note.",
"properties": {
"encounter_diagnoses_coding": {
"type": "array",
"description": "The ICD-10 coding for the patient's active encounter diagnoses. If the template used for the note generation contains an `ASSESSMENT_AND_PLAN` section, these diagnoses will be used for the \"by problem\" structuration of this section if they are discussed during the encounter.",
"items": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
],
"title": "icd10_entry_request"
}
},
"patient_demographics": {
"type": "object",
"description": "Demographic details about the patient.",
"properties": {
"name": {
"type": "string",
"description": "The patient's name."
},
"birth_date": {
"type": "string",
"format": "date",
"description": "The patient's birthdate (YYYY-MM-DD format).",
"example": "1996-03-21"
},
"gender": {
"type": "string",
"enum": [
"MALE",
"FEMALE",
"OTHER"
],
"description": "The patient's gender.",
"title": "gender"
},
"pronouns": {
"type": "string",
"enum": [
"HE_HIM",
"SHE_HER",
"THEY_THEM"
],
"description": "The patient's pronouns.",
"title": "pronouns"
}
},
"required": [
"name"
],
"title": "patient_demographics"
},
"source_note": {
"type": "object",
"description": "A source note used as input to follow-up note generation. The list of accepted section kinds depends on the target template — see the template introspection endpoint's `supported_source_note_section_kinds` field.",
"required": [
"type",
"sections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"DRAFT",
"LAST_SIGNED"
],
"description": "Nature of the source note. `DRAFT` is the provider's in-progress note for the current encounter; `LAST_SIGNED` is the patient's most recent signed note from a previous encounter."
},
"sections": {
"type": "array",
"description": "Semantic sections taken as a starting point for follow-up note generation. Each `kind` may appear at most once.",
"items": {
"type": "object",
"description": "A semantic section of a source note used as input to follow-up note generation.",
"required": [
"kind",
"content"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"ASSESSMENT_AND_PLAN",
"ASSESSMENT",
"PLAN"
],
"description": "The semantic meaning of a section. This is independent of the template's section layout and identifies what kind of clinical content the section carries (e.g. an Assessment & Plan combined section, or a standalone Assessment or Plan).\nThe kinds listed here are subject to change: new values can be added independently of API versions. Keep your client tolerant to new enum values.",
"title": "semantic_section_kind"
},
"content": {
"description": "Content of the section. `SUBSECTIONS` is additionally accepted on the `ASSESSMENT_AND_PLAN` kind, one subsection per clinical problem.",
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"title": "source_note_section"
}
}
},
"title": "source_note"
}
},
"title": "structured_context_request"
},
"specialty": {
"type": "string",
"description": "The medical specialty of the provider.",
"nullable": true,
"enum": [
"ADDICTION_MEDICINE",
"PAIN_MEDICINE",
"ALLERGY_AND_IMMUNOLOGY",
"ANESTHESIOLOGY",
"ONCOLOGY",
"CARDIOLOGY",
"SURGERY",
"DERMATOLOGY",
"DIABETOLOGY",
"ENDOCRINOLOGY",
"GENETICS",
"GERIATRICS",
"GYNECOLOGY",
"HEMATOLOGY",
"HEPATOLOGY",
"GASTROENTEROLOGY",
"SPORTS_MEDICINE",
"OCCUPATIONAL_MEDICINE",
"GENERAL_MEDICINE",
"FORENSIC_MEDICINE",
"PHYSICAL_MEDICINE_AND_REHABILITATION",
"NEPHROLOGY",
"NEUROLOGY",
"NUTRITION",
"DIETETICS",
"OPHTHALMOLOGY",
"ENT",
"PEDIATRICS",
"PULMONOLOGY",
"PSYCHIATRY",
"RHEUMATOLOGY",
"RADIOLOGY",
"IMMUNOLOGY",
"INFECTIOUS_DISEASE",
"SEXUAL_MEDICINE",
"TOXICOLOGY",
"UROLOGY",
"MIDWIFE",
"EMERGENCY_MEDICINE",
"NURSE",
"PSYCHOLOGY",
"PSYCHOTHERAPY",
"INTERNAL_MEDICINE",
"FAMILY_MEDICINE",
"DENTIST",
"VETERINARIAN",
"PHYSIOTHERAPY",
"CHIROPRACTIC",
"OSTEOPATHIC_MEDICINE",
"ORTHOPEDICS",
"OTHER",
"LACTATION_CONSULTANT",
"PODIATRY",
"GENERAL_PRACTICE",
"HOSPITAL_MEDICINE",
"BEHAVIORAL_HEALTH",
"MENTAL_HEALTH",
"SUBSTANCE_USE_DISORDER",
"VASCULAR_MEDICINE",
"LIFESTYLE_MEDICINE",
"PREVENTIVE_MEDICINE",
"PUBLIC_HEALTH",
"ADOLESCENT_MEDICINE",
"WOUND_CARE",
"NEUROSURGERY",
"PLASTIC_SURGERY",
"PALLIATIVE_CARE",
"TRANSPLANT_MEDICINE",
"OBESITY_MEDICINE",
"CASE_MANAGEMENT",
"CARE_MANAGEMENT",
"CARE_COORDINATION",
"SOCIAL_WORK",
"PATHOLOGY",
"RADIATION_ONCOLOGY",
"SLEEP_MEDICINE",
"AUDIOLOGY",
"REPRODUCTIVE_ENDOCRINOLOGY",
"PHARMACIST",
"OCCUPATIONAL_THERAPY",
"SPEECH_LANGUAGE_PATHOLOGY"
],
"example": "GENERAL_PRACTICE",
"title": "specialty_kind"
},
"encounter_date": {
"type": "string",
"format": "date",
"description": "The date of the encounter in YYYY-MM-DD format. It is recommended to always provide this field to improve the quality of the generated note. When provided, this date grounds relative temporal references (e.g., \"last year\") in the generated note. Defaults to today's date when omitted.",
"example": "2026-03-24"
}
},
"required": [
"transcript_items",
"note_locale"
],
"title": "generate_note_request"
},
"output": {
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
}
},
"title": "create_report_payload_generate_note_request_output"
},
"expected_output": {
"description": "The expected version of `output`. This is typically an improved version of the Nabla-generated note after it has been corrected or adjusted by the healthcare provider.",
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
}
},
"title": "create_report_payload_generate_note_request_output"
}
}
},
{
"title": "GENERATE_PATIENT_INSTRUCTIONS",
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"type": "string",
"enum": [
"GENERATE_PATIENT_INSTRUCTIONS"
],
"description": "The report is about a call to the [Generate Patient Instructions](/core-api/reference/next/server/copilot-generate-patient-instructions) endpoint."
},
"input": {
"type": "object",
"description": "The input to generate the patient instructions.",
"properties": {
"note": {
"description": "The Nabla-generated clinical note of the encounter.",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
},
"instructions_locale": {
"description": "Locale of the patient instructions.",
"type": "string",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"SPANISH_ES",
"SPANISH_MX",
"FRENCH_FR",
"ARABIC_EG",
"ARABIC_LB",
"ARABIC_MA",
"ARABIC_SA",
"ARMENIAN_AM",
"BENGALI_IN",
"CANTONESE_CN",
"CROATIAN_HR",
"FILIPINO_PH",
"GERMAN_DE",
"GREEK_GR",
"GUJARATI_IN",
"HEBREW_IL",
"HINDI_IN",
"ITALIAN_IT",
"JAPANESE_JP",
"KHMER_KH",
"KOREAN_KR",
"MANDARIN_CN",
"PERSIAN_IR",
"POLISH_PL",
"PORTUGUESE_PT",
"PUNJABI_IN",
"RUSSIAN_RU",
"SERBIAN_RS",
"TAMIL_IN",
"TELUGU_IN",
"THAI_TH",
"URDU_IN",
"VIETNAMESE_VN",
"HAITIAN_HT"
],
"example": "ENGLISH_US",
"title": "speech_locale"
},
"recipient_type": {
"type": "string",
"enum": [
"PATIENT",
"PARENT"
],
"description": "Recipient type of the patient instructions. This is especially useful for pediatric encounters.",
"default": "PATIENT",
"example": "PATIENT",
"title": "patient_instructions_recipient_type"
}
},
"required": [
"note",
"instructions_locale"
],
"title": "generate_patient_instructions_request"
},
"output": {
"type": "object",
"required": [
"instructions"
],
"properties": {
"instructions": {
"type": "string"
}
},
"title": "create_report_payload_generate_patient_instructions_request_output"
},
"expected_output": {
"description": "The expected version of `output`. This is typically an improved version of the Nabla-generated patient instructions after they have been corrected or adjusted by the healthcare provider.",
"type": "object",
"required": [
"instructions"
],
"properties": {
"instructions": {
"type": "string"
}
},
"title": "create_report_payload_generate_patient_instructions_request_output"
}
}
},
{
"title": "GENERATE_NORMALIZED_DATA",
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"type": "string",
"enum": [
"GENERATE_NORMALIZED_DATA"
],
"description": "The report is about a call to the [Generate Normalized Data](/core-api/reference/next/server/generate-normalized-data) endpoint."
},
"input": {
"type": "object",
"properties": {
"note": {
"description": "The Nabla-generated clinical note to normalize.",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
},
"encounter_diagnoses_coding": {
"type": "array",
"description": "The ICD-10 coding for the patient's active encounter diagnoses. If some of them are found to apply to the current note, they will be prioritized in the normalization process.",
"items": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
],
"title": "icd10_entry_request"
}
}
},
"required": [
"note"
],
"title": "generate_normalized_data_request"
},
"output": {
"type": "object",
"required": [
"conditions"
],
"properties": {
"conditions": {
"description": "FHIR conditions (including their ICD-10 code) corresponding to the patient's medical conditions as mentioned in the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"properties": {
"clinical_status": {
"type": "string",
"enum": [
"ACTIVE",
"RESOLVED"
],
"description": "The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `ACTIVE` and `RESOLVED` are supported for now.",
"example": "ACTIVE",
"title": "fhir_condition_clinical_status"
},
"coding": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"alternative_coding": {
"type": "array",
"description": "An array of ICD-10 codes that are closely related to the primary coding and represent plausible alternative coding for the condition.",
"items": {
"type": "object",
"description": "An ICD-10 entry including HCC and MCC information.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
}
},
"categories": {
"description": "Categories of the condition.",
"type": "array",
"items": {
"type": "string",
"enum": [
"PROBLEM_LIST_ITEM",
"ENCOUNTER_DIAGNOSIS"
],
"description": "The category of a [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"example": "PROBLEM_LIST_ITEM",
"title": "fhir_condition_category"
}
},
"subsection_id": {
"description": "Identifier of the Assessment & Plan subsection this condition was extracted from. Matches `content.subsections[].id` when applicable. Absent or `null` otherwise.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
}
},
"required": [
"coding",
"alternative_coding"
]
}
},
"observations": {
"description": "FHIR observations (including their LOINC code) extracted from the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR observation](https://www.hl7.org/fhir/observation.html).",
"properties": {
"coding": {
"type": "object",
"description": "LOINC coding representation of this observation.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only LOINC is supported for now.",
"enum": [
"http://loinc.org"
]
},
"code": {
"type": "string",
"example": "29463-7",
"description": "Code of the LOINC entry."
},
"display": {
"type": "string",
"example": "Body weight",
"description": "Description of the LOINC entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"value_quantity": {
"type": "object",
"description": "Value quantity for an observation.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"value_range": {
"type": "object",
"description": "Value range for an observation.",
"properties": {
"low": {
"type": "object",
"description": "The lower bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"high": {
"type": "object",
"description": "The higher bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
}
},
"required": [
"low",
"high"
]
},
"note": {
"type": "string",
"description": "Additional comment about the observation.",
"example": "Measured at rest."
}
},
"required": [
"coding"
]
}
}
},
"title": "create_report_payload_generate_normalized_data_request_output"
},
"expected_output": {
"description": "The expected version of `output`. This is typically an improved version of the Nabla-generated normalized data after it has been corrected or adjusted by the healthcare provider.",
"type": "object",
"required": [
"conditions"
],
"properties": {
"conditions": {
"description": "FHIR conditions (including their ICD-10 code) corresponding to the patient's medical conditions as mentioned in the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"properties": {
"clinical_status": {
"type": "string",
"enum": [
"ACTIVE",
"RESOLVED"
],
"description": "The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `ACTIVE` and `RESOLVED` are supported for now.",
"example": "ACTIVE",
"title": "fhir_condition_clinical_status"
},
"coding": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"alternative_coding": {
"type": "array",
"description": "An array of ICD-10 codes that are closely related to the primary coding and represent plausible alternative coding for the condition.",
"items": {
"type": "object",
"description": "An ICD-10 entry including HCC and MCC information.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
}
},
"categories": {
"description": "Categories of the condition.",
"type": "array",
"items": {
"type": "string",
"enum": [
"PROBLEM_LIST_ITEM",
"ENCOUNTER_DIAGNOSIS"
],
"description": "The category of a [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"example": "PROBLEM_LIST_ITEM",
"title": "fhir_condition_category"
}
},
"subsection_id": {
"description": "Identifier of the Assessment & Plan subsection this condition was extracted from. Matches `content.subsections[].id` when applicable. Absent or `null` otherwise.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
}
},
"required": [
"coding",
"alternative_coding"
]
}
},
"observations": {
"description": "FHIR observations (including their LOINC code) extracted from the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR observation](https://www.hl7.org/fhir/observation.html).",
"properties": {
"coding": {
"type": "object",
"description": "LOINC coding representation of this observation.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only LOINC is supported for now.",
"enum": [
"http://loinc.org"
]
},
"code": {
"type": "string",
"example": "29463-7",
"description": "Code of the LOINC entry."
},
"display": {
"type": "string",
"example": "Body weight",
"description": "Description of the LOINC entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"value_quantity": {
"type": "object",
"description": "Value quantity for an observation.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"value_range": {
"type": "object",
"description": "Value range for an observation.",
"properties": {
"low": {
"type": "object",
"description": "The lower bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"high": {
"type": "object",
"description": "The higher bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
}
},
"required": [
"low",
"high"
]
},
"note": {
"type": "string",
"description": "Additional comment about the observation.",
"example": "Measured at rest."
}
},
"required": [
"coding"
]
}
}
},
"title": "create_report_payload_generate_normalized_data_request_output"
}
}
}
],
"discriminator": {
"propertyName": "endpoint",
"mapping": {
"GENERATE_NOTE": {
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"type": "string",
"enum": [
"GENERATE_NOTE"
],
"description": "The report is about a call to the [Generate Note](/core-api/reference/next/server/generate-note) endpoint (or its async version)."
},
"input": {
"type": "object",
"description": "Input for note generation.",
"properties": {
"note_locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"transcript_items": {
"type": "array",
"description": "The transcript from which to generate the note.\n\nYou don't need to specify each item's start or end time, but make sure they are sorted. In fact, due to its asynchronous nature, our [real-time transcription API](/core-api/reference/next/server/transcribe-ws) does not guarantee its results order. Thus, before calling this note-generation API please **filter-out non-final items and sort them by `start_offset_ms`**.",
"items": {
"type": "object",
"description": "A portion of the transcribed consultation.",
"properties": {
"text": {
"type": "string",
"description": "The transcribed text.",
"example": "Also, I’m allergic to peanuts."
},
"speaker_type": {
"type": "string",
"enum": [
"DOCTOR",
"PATIENT",
"UNSPECIFIED"
],
"description": "Who said the text in this transcript item.",
"example": "DOCTOR",
"title": "speaker"
}
},
"required": [
"text",
"speaker_type"
],
"title": "transcript_item_request"
}
},
"note_template_key": {
"type": "string",
"description": "Human-readable identifier for the note template to use for generation. Use [List note templates](/core-api/reference/next/server/list-generate-note-templates) to get available keys."
},
"note_sections_customization": {
"type": "array",
"items": {
"type": "object",
"properties": {
"section_key": {
"type": "string",
"title": "note_section_key",
"description": "Key of the note section this customization should apply to.",
"example": "CHIEF_COMPLAINT"
},
"custom_instruction": {
"type": "string",
"maxLength": 700,
"example": "Include discussion about first symptoms",
"description": "Allow to customize a note section by providing specific guidelines. These guidelines must be as clear and concise as possible for best results.",
"title": "note_section_customization_custom_instruction"
},
"style": {
"type": "string",
"enum": [
"AUTO",
"PARAGRAPH",
"BULLET_POINTS"
],
"example": "PARAGRAPH",
"description": "Specifies the desired style for the note section:\n\n • `PARAGRAPH`: Prioritizes generating paragraphs;\n\n • `BULLET_POINTS`: Prioritizes structuring content using bullet points.\n\n • `AUTO`: Automatically picks the most natural formatting option.\n\nDefault is `AUTO`.",
"title": "note_section_customization_section_style"
},
"level_of_detail": {
"type": "string",
"enum": [
"DEFAULT",
"DETAILED"
],
"description": "Specifies the desired level of details. Use `detailed` to get more details in the note section.",
"title": "note_section_customization_level_of_detail"
},
"split_by_problem": {
"type": "boolean",
"description": "Flag to structure the content of the note sections according to distinct clinical problems or topics addressed during the consultation."
}
},
"required": [
"section_key"
],
"title": "note_section_customization_request"
},
"description": "Advanced per-section customization options for the chosen template.\n\nYou should **only specify sections that belong to the given template**, and **only specify customization options that are supported for the given section**. Also, only specify sections you want to customize, no need to be exhaustive.\n\n\nCheck [Note templates sections](/next/core-api/guides/note-templates/note-customization) for compatibility matrix."
},
"note_template_custom_instructions": {
"type": "string",
"nullable": true,
"maxLength": 700,
"description": "Optional note-level (template-level) guidelines applied across the whole note for this template.",
"example": "Prefer concise bullet-style phrasing throughout the note."
},
"current_note": {
"description": "Optional note from a previous transcription session, to be updated using the new `transcript_items`. This is useful if you generate notes gradually to avoid accumulating a very long transcript items list.\nThe `template` and `locale` fields describe the note being passed in and do not control the output.",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
},
"unstructured_context": {
"type": "string",
"description": "Some unstructured contextual information that will be used to generate the note (for example name, gender, age, pronouns, medical history). For better information processing, please prioritize passing information in a structured manner via the `structured_context` field. Generating the note will take longer if you pass a long `unstructured_context`.",
"maxLength": 10000
},
"structured_context": {
"type": "object",
"description": "Structured context about the patient and the encounter, which will be taken into account when generating the note.",
"properties": {
"encounter_diagnoses_coding": {
"type": "array",
"description": "The ICD-10 coding for the patient's active encounter diagnoses. If the template used for the note generation contains an `ASSESSMENT_AND_PLAN` section, these diagnoses will be used for the \"by problem\" structuration of this section if they are discussed during the encounter.",
"items": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
],
"title": "icd10_entry_request"
}
},
"patient_demographics": {
"type": "object",
"description": "Demographic details about the patient.",
"properties": {
"name": {
"type": "string",
"description": "The patient's name."
},
"birth_date": {
"type": "string",
"format": "date",
"description": "The patient's birthdate (YYYY-MM-DD format).",
"example": "1996-03-21"
},
"gender": {
"type": "string",
"enum": [
"MALE",
"FEMALE",
"OTHER"
],
"description": "The patient's gender.",
"title": "gender"
},
"pronouns": {
"type": "string",
"enum": [
"HE_HIM",
"SHE_HER",
"THEY_THEM"
],
"description": "The patient's pronouns.",
"title": "pronouns"
}
},
"required": [
"name"
],
"title": "patient_demographics"
},
"source_note": {
"type": "object",
"description": "A source note used as input to follow-up note generation. The list of accepted section kinds depends on the target template — see the template introspection endpoint's `supported_source_note_section_kinds` field.",
"required": [
"type",
"sections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"DRAFT",
"LAST_SIGNED"
],
"description": "Nature of the source note. `DRAFT` is the provider's in-progress note for the current encounter; `LAST_SIGNED` is the patient's most recent signed note from a previous encounter."
},
"sections": {
"type": "array",
"description": "Semantic sections taken as a starting point for follow-up note generation. Each `kind` may appear at most once.",
"items": {
"type": "object",
"description": "A semantic section of a source note used as input to follow-up note generation.",
"required": [
"kind",
"content"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"ASSESSMENT_AND_PLAN",
"ASSESSMENT",
"PLAN"
],
"description": "The semantic meaning of a section. This is independent of the template's section layout and identifies what kind of clinical content the section carries (e.g. an Assessment & Plan combined section, or a standalone Assessment or Plan).\nThe kinds listed here are subject to change: new values can be added independently of API versions. Keep your client tolerant to new enum values.",
"title": "semantic_section_kind"
},
"content": {
"description": "Content of the section. `SUBSECTIONS` is additionally accepted on the `ASSESSMENT_AND_PLAN` kind, one subsection per clinical problem.",
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"title": "source_note_section"
}
}
},
"title": "source_note"
}
},
"title": "structured_context_request"
},
"specialty": {
"type": "string",
"description": "The medical specialty of the provider.",
"nullable": true,
"enum": [
"ADDICTION_MEDICINE",
"PAIN_MEDICINE",
"ALLERGY_AND_IMMUNOLOGY",
"ANESTHESIOLOGY",
"ONCOLOGY",
"CARDIOLOGY",
"SURGERY",
"DERMATOLOGY",
"DIABETOLOGY",
"ENDOCRINOLOGY",
"GENETICS",
"GERIATRICS",
"GYNECOLOGY",
"HEMATOLOGY",
"HEPATOLOGY",
"GASTROENTEROLOGY",
"SPORTS_MEDICINE",
"OCCUPATIONAL_MEDICINE",
"GENERAL_MEDICINE",
"FORENSIC_MEDICINE",
"PHYSICAL_MEDICINE_AND_REHABILITATION",
"NEPHROLOGY",
"NEUROLOGY",
"NUTRITION",
"DIETETICS",
"OPHTHALMOLOGY",
"ENT",
"PEDIATRICS",
"PULMONOLOGY",
"PSYCHIATRY",
"RHEUMATOLOGY",
"RADIOLOGY",
"IMMUNOLOGY",
"INFECTIOUS_DISEASE",
"SEXUAL_MEDICINE",
"TOXICOLOGY",
"UROLOGY",
"MIDWIFE",
"EMERGENCY_MEDICINE",
"NURSE",
"PSYCHOLOGY",
"PSYCHOTHERAPY",
"INTERNAL_MEDICINE",
"FAMILY_MEDICINE",
"DENTIST",
"VETERINARIAN",
"PHYSIOTHERAPY",
"CHIROPRACTIC",
"OSTEOPATHIC_MEDICINE",
"ORTHOPEDICS",
"OTHER",
"LACTATION_CONSULTANT",
"PODIATRY",
"GENERAL_PRACTICE",
"HOSPITAL_MEDICINE",
"BEHAVIORAL_HEALTH",
"MENTAL_HEALTH",
"SUBSTANCE_USE_DISORDER",
"VASCULAR_MEDICINE",
"LIFESTYLE_MEDICINE",
"PREVENTIVE_MEDICINE",
"PUBLIC_HEALTH",
"ADOLESCENT_MEDICINE",
"WOUND_CARE",
"NEUROSURGERY",
"PLASTIC_SURGERY",
"PALLIATIVE_CARE",
"TRANSPLANT_MEDICINE",
"OBESITY_MEDICINE",
"CASE_MANAGEMENT",
"CARE_MANAGEMENT",
"CARE_COORDINATION",
"SOCIAL_WORK",
"PATHOLOGY",
"RADIATION_ONCOLOGY",
"SLEEP_MEDICINE",
"AUDIOLOGY",
"REPRODUCTIVE_ENDOCRINOLOGY",
"PHARMACIST",
"OCCUPATIONAL_THERAPY",
"SPEECH_LANGUAGE_PATHOLOGY"
],
"example": "GENERAL_PRACTICE",
"title": "specialty_kind"
},
"encounter_date": {
"type": "string",
"format": "date",
"description": "The date of the encounter in YYYY-MM-DD format. It is recommended to always provide this field to improve the quality of the generated note. When provided, this date grounds relative temporal references (e.g., \"last year\") in the generated note. Defaults to today's date when omitted.",
"example": "2026-03-24"
}
},
"required": [
"transcript_items",
"note_locale"
],
"title": "generate_note_request"
},
"output": {
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
}
},
"title": "create_report_payload_generate_note_request_output"
},
"expected_output": {
"description": "The expected version of `output`. This is typically an improved version of the Nabla-generated note after it has been corrected or adjusted by the healthcare provider.",
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
}
},
"title": "create_report_payload_generate_note_request_output"
}
},
"title": "create_report_payload_generate_note_request"
},
"GENERATE_PATIENT_INSTRUCTIONS": {
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"type": "string",
"enum": [
"GENERATE_PATIENT_INSTRUCTIONS"
],
"description": "The report is about a call to the [Generate Patient Instructions](/core-api/reference/next/server/copilot-generate-patient-instructions) endpoint."
},
"input": {
"type": "object",
"description": "The input to generate the patient instructions.",
"properties": {
"note": {
"description": "The Nabla-generated clinical note of the encounter.",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
},
"instructions_locale": {
"description": "Locale of the patient instructions.",
"type": "string",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"SPANISH_ES",
"SPANISH_MX",
"FRENCH_FR",
"ARABIC_EG",
"ARABIC_LB",
"ARABIC_MA",
"ARABIC_SA",
"ARMENIAN_AM",
"BENGALI_IN",
"CANTONESE_CN",
"CROATIAN_HR",
"FILIPINO_PH",
"GERMAN_DE",
"GREEK_GR",
"GUJARATI_IN",
"HEBREW_IL",
"HINDI_IN",
"ITALIAN_IT",
"JAPANESE_JP",
"KHMER_KH",
"KOREAN_KR",
"MANDARIN_CN",
"PERSIAN_IR",
"POLISH_PL",
"PORTUGUESE_PT",
"PUNJABI_IN",
"RUSSIAN_RU",
"SERBIAN_RS",
"TAMIL_IN",
"TELUGU_IN",
"THAI_TH",
"URDU_IN",
"VIETNAMESE_VN",
"HAITIAN_HT"
],
"example": "ENGLISH_US",
"title": "speech_locale"
},
"recipient_type": {
"type": "string",
"enum": [
"PATIENT",
"PARENT"
],
"description": "Recipient type of the patient instructions. This is especially useful for pediatric encounters.",
"default": "PATIENT",
"example": "PATIENT",
"title": "patient_instructions_recipient_type"
}
},
"required": [
"note",
"instructions_locale"
],
"title": "generate_patient_instructions_request"
},
"output": {
"type": "object",
"required": [
"instructions"
],
"properties": {
"instructions": {
"type": "string"
}
},
"title": "create_report_payload_generate_patient_instructions_request_output"
},
"expected_output": {
"description": "The expected version of `output`. This is typically an improved version of the Nabla-generated patient instructions after they have been corrected or adjusted by the healthcare provider.",
"type": "object",
"required": [
"instructions"
],
"properties": {
"instructions": {
"type": "string"
}
},
"title": "create_report_payload_generate_patient_instructions_request_output"
}
},
"title": "create_report_payload_generate_patient_instructions_request"
},
"GENERATE_NORMALIZED_DATA": {
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"type": "string",
"enum": [
"GENERATE_NORMALIZED_DATA"
],
"description": "The report is about a call to the [Generate Normalized Data](/core-api/reference/next/server/generate-normalized-data) endpoint."
},
"input": {
"type": "object",
"properties": {
"note": {
"description": "The Nabla-generated clinical note to normalize.",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the note.",
"example": "Fever and strong headache"
},
"sections": {
"type": "array",
"description": "Sections of the note.",
"items": {
"type": "object",
"description": "A note section.",
"properties": {
"key": {
"type": "string",
"description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/next/core-api/guides/note-templates/note-templates-sections) for possible values.",
"example": "CHIEF_COMPLAINT",
"title": "note_section_key"
},
"title": {
"type": "string",
"description": "The section title.",
"example": "Chief complaint"
},
"content": {
"oneOf": [
{
"title": "TEXT",
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
}
},
{
"title": "SUBSECTIONS",
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
}
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"TEXT": {
"type": "object",
"description": "Plain-text note section content.",
"required": [
"type",
"text"
],
"properties": {
"type": {
"type": "string",
"enum": [
"TEXT"
]
},
"text": {
"type": "string",
"description": "Content of the note section."
}
},
"title": "note_section_content_text_request"
},
"SUBSECTIONS": {
"type": "object",
"description": "Structured note section content as subsections.",
"required": [
"type",
"subsections"
],
"properties": {
"type": {
"type": "string",
"enum": [
"SUBSECTIONS"
]
},
"subsections": {
"type": "array",
"minItems": 1,
"description": "Structured subsections. Allowed only on the Assessment & Plan section of A&P-merged templates. Order is significant.",
"items": {
"type": "object",
"description": "A subsection of a note section. Currently only used on the Assessment & Plan section of A&P-merged templates.",
"properties": {
"id": {
"description": "Stable identifier for this subsection. Echoed on normalized conditions via `subsection_id`.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
},
"title": {
"type": "string",
"description": "Short subsection title (typically a clinical problem name). May be absent (e.g. subsections appended by dot phrase auto-apply)."
},
"text": {
"type": "string",
"description": "Free-text content of the subsection. May be absent if the subsection only carries a title."
}
},
"required": [
"id"
],
"title": "note_section_subsection_request"
}
}
},
"title": "note_section_content_subsections_request"
}
}
},
"title": "note_section_content_request"
}
},
"required": [
"key",
"title",
"content"
],
"title": "note_section_request"
}
},
"locale": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
},
"template_key": {
"type": "string",
"description": "Human-readable identifier for the note template used to generate this note."
}
},
"required": [
"sections",
"locale",
"template_key"
],
"title": "note_request"
},
"encounter_diagnoses_coding": {
"type": "array",
"description": "The ICD-10 coding for the patient's active encounter diagnoses. If some of them are found to apply to the current note, they will be prioritized in the normalization process.",
"items": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
],
"title": "icd10_entry_request"
}
}
},
"required": [
"note"
],
"title": "generate_normalized_data_request"
},
"output": {
"type": "object",
"required": [
"conditions"
],
"properties": {
"conditions": {
"description": "FHIR conditions (including their ICD-10 code) corresponding to the patient's medical conditions as mentioned in the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"properties": {
"clinical_status": {
"type": "string",
"enum": [
"ACTIVE",
"RESOLVED"
],
"description": "The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `ACTIVE` and `RESOLVED` are supported for now.",
"example": "ACTIVE",
"title": "fhir_condition_clinical_status"
},
"coding": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"alternative_coding": {
"type": "array",
"description": "An array of ICD-10 codes that are closely related to the primary coding and represent plausible alternative coding for the condition.",
"items": {
"type": "object",
"description": "An ICD-10 entry including HCC and MCC information.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
}
},
"categories": {
"description": "Categories of the condition.",
"type": "array",
"items": {
"type": "string",
"enum": [
"PROBLEM_LIST_ITEM",
"ENCOUNTER_DIAGNOSIS"
],
"description": "The category of a [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"example": "PROBLEM_LIST_ITEM",
"title": "fhir_condition_category"
}
},
"subsection_id": {
"description": "Identifier of the Assessment & Plan subsection this condition was extracted from. Matches `content.subsections[].id` when applicable. Absent or `null` otherwise.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
}
},
"required": [
"coding",
"alternative_coding"
]
}
},
"observations": {
"description": "FHIR observations (including their LOINC code) extracted from the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR observation](https://www.hl7.org/fhir/observation.html).",
"properties": {
"coding": {
"type": "object",
"description": "LOINC coding representation of this observation.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only LOINC is supported for now.",
"enum": [
"http://loinc.org"
]
},
"code": {
"type": "string",
"example": "29463-7",
"description": "Code of the LOINC entry."
},
"display": {
"type": "string",
"example": "Body weight",
"description": "Description of the LOINC entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"value_quantity": {
"type": "object",
"description": "Value quantity for an observation.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"value_range": {
"type": "object",
"description": "Value range for an observation.",
"properties": {
"low": {
"type": "object",
"description": "The lower bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"high": {
"type": "object",
"description": "The higher bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
}
},
"required": [
"low",
"high"
]
},
"note": {
"type": "string",
"description": "Additional comment about the observation.",
"example": "Measured at rest."
}
},
"required": [
"coding"
]
}
}
},
"title": "create_report_payload_generate_normalized_data_request_output"
},
"expected_output": {
"description": "The expected version of `output`. This is typically an improved version of the Nabla-generated normalized data after it has been corrected or adjusted by the healthcare provider.",
"type": "object",
"required": [
"conditions"
],
"properties": {
"conditions": {
"description": "FHIR conditions (including their ICD-10 code) corresponding to the patient's medical conditions as mentioned in the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"properties": {
"clinical_status": {
"type": "string",
"enum": [
"ACTIVE",
"RESOLVED"
],
"description": "The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `ACTIVE` and `RESOLVED` are supported for now.",
"example": "ACTIVE",
"title": "fhir_condition_clinical_status"
},
"coding": {
"type": "object",
"description": "An ICD-10 entry.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"alternative_coding": {
"type": "array",
"description": "An array of ICD-10 codes that are closely related to the primary coding and represent plausible alternative coding for the condition.",
"items": {
"type": "object",
"description": "An ICD-10 entry including HCC and MCC information.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only ICD-10 is supported for now.",
"enum": [
"http://hl7.org/fhir/sid/icd-10-cm"
]
},
"code": {
"type": "string",
"example": "G44.8",
"description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
},
"display": {
"type": "string",
"example": "Other specified headache syndromes.",
"description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry."
}
},
"required": [
"code",
"display",
"system"
]
}
},
"categories": {
"description": "Categories of the condition.",
"type": "array",
"items": {
"type": "string",
"enum": [
"PROBLEM_LIST_ITEM",
"ENCOUNTER_DIAGNOSIS"
],
"description": "The category of a [FHIR condition](https://www.hl7.org/fhir/condition.html).",
"example": "PROBLEM_LIST_ITEM",
"title": "fhir_condition_category"
}
},
"subsection_id": {
"description": "Identifier of the Assessment & Plan subsection this condition was extracted from. Matches `content.subsections[].id` when applicable. Absent or `null` otherwise.",
"type": "string",
"format": "uuid",
"example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
"title": "uuid"
}
},
"required": [
"coding",
"alternative_coding"
]
}
},
"observations": {
"description": "FHIR observations (including their LOINC code) extracted from the clinical note.",
"type": "array",
"items": {
"type": "object",
"description": "Structured [FHIR observation](https://www.hl7.org/fhir/observation.html).",
"properties": {
"coding": {
"type": "object",
"description": "LOINC coding representation of this observation.",
"properties": {
"system": {
"type": "string",
"description": "The used coding system, only LOINC is supported for now.",
"enum": [
"http://loinc.org"
]
},
"code": {
"type": "string",
"example": "29463-7",
"description": "Code of the LOINC entry."
},
"display": {
"type": "string",
"example": "Body weight",
"description": "Description of the LOINC entry."
}
},
"required": [
"code",
"display",
"system"
]
},
"value_quantity": {
"type": "object",
"description": "Value quantity for an observation.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"value_range": {
"type": "object",
"description": "Value range for an observation.",
"properties": {
"low": {
"type": "object",
"description": "The lower bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
},
"high": {
"type": "object",
"description": "The higher bound of the range.",
"properties": {
"value": {
"type": "number",
"description": "The value of the quantity."
},
"unit": {
"type": "string",
"description": "The unit of the observation quantity.",
"enum": [
"METER",
"CENTIMETER",
"FOOT",
"KILOGRAM",
"POUND",
"MILLIMETERS_OF_MERCURY",
"CENTIMETERS_OF_MERCURY",
"CELSIUS",
"FAHRENHEIT",
"BEATS_PER_MINUTE",
"BREATHS_PER_MINUTE",
"LITER_PER_MINUTE",
"MILLIMETER",
"PERCENT",
"INCH"
],
"title": "observation_value_unit"
},
"system": {
"type": "string",
"description": "The used coding system, only UCUM is supported for now.",
"enum": [
"https://ucum.org"
]
},
"code": {
"type": "string",
"description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.",
"example": "kg"
}
},
"required": [
"value",
"system"
]
}
},
"required": [
"low",
"high"
]
},
"note": {
"type": "string",
"description": "Additional comment about the observation.",
"example": "Measured at rest."
}
},
"required": [
"coding"
]
}
}
},
"title": "create_report_payload_generate_normalized_data_request_output"
}
},
"title": "create_report_payload_generate_normalized_data_request"
}
}
},
"title": "create_report_payload_request"
}
},
"required": [
"payload"
],
"title": "create_report_request"
}
}
}
},
"responses": {
"200": {
"description": "The created report id, to be referenced when emailing support.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
}
}
}
}
}
}
}