Elation Health · Schema

Letter

HealthcareUnited StatesElectronic Health RecordsFHIRHL7InteroperabilitySMART on FHIRPrimary CareValue-Based CareEligibilityClinical DataSchedulinge-PrescribingDigital HealthA2A

Properties

Name	Type	Description
attachments	array
body	string	The body of the letter.
created_date	stringnull
deleted_date	stringnull
delivery_date	stringnull
delivery_method	object
direct_message_status	stringnull
direct_message_to	stringnull
display_to	stringnull
document_date	string
email_to	stringnull
failure_unacknowledged	string
fax_attachments	boolean
fax_status	string
fax_to	stringnull
id	integer
is_processed	boolean
letter_type	string
patient	integer
practice	integer
referral_order	integernull
send_out	boolean
send_to_contact	object
send_to_elation_user	integer	If a letter is sent to another elation user, this will be that user's id.
send_to_name	stringnull
sign_date	stringnull
signed_by	integernull	The user who signed the letter.
subject	string	The subject of the letter (Not needed with referral_order).
tags	array	A list of Document Tags associated with the letter.
to_number	stringnull
viewed_at	stringnull
with_archive	boolean

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/elation-health/main/json-schema/elation-health-letter-schema.json",
  "title": "Letter",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/elation-health-referrals-api-openapi.yml#/components/schemas/Letter",
  "properties": {
    "attachments": {
      "items": {
        "$ref": "#/$defs/LetterAttachment"
      },
      "type": "array"
    },
    "body": {
      "description": "The body of the letter.",
      "type": "string"
    },
    "created_date": {
      "format": "date-time",
      "readOnly": true,
      "type": [
        "string",
        "null"
      ]
    },
    "deleted_date": {
      "format": "date-time",
      "readOnly": true,
      "type": [
        "string",
        "null"
      ]
    },
    "delivery_date": {
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "delivery_method": {
      "$ref": "#/$defs/DeliveryMethodEnum"
    },
    "direct_message_status": {
      "readOnly": true,
      "type": [
        "string",
        "null"
      ]
    },
    "direct_message_to": {
      "maxLength": 200,
      "type": [
        "string",
        "null"
      ]
    },
    "display_to": {
      "readOnly": true,
      "type": [
        "string",
        "null"
      ]
    },
    "document_date": {
      "format": "date-time",
      "type": "string"
    },
    "email_to": {
      "maxLength": 200,
      "type": [
        "string",
        "null"
      ]
    },
    "failure_unacknowledged": {
      "type": "string"
    },
    "fax_attachments": {
      "type": "boolean"
    },
    "fax_status": {
      "readOnly": true,
      "type": "string"
    },
    "fax_to": {
      "maxLength": 20,
      "type": [
        "string",
        "null"
      ]
    },
    "id": {
      "readOnly": true,
      "type": "integer"
    },
    "is_processed": {
      "readOnly": true,
      "type": "boolean"
    },
    "letter_type": {
      "readOnly": true,
      "type": "string"
    },
    "patient": {
      "format": "int64",
      "type": "integer"
    },
    "practice": {
      "format": "int64",
      "type": "integer"
    },
    "referral_order": {
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    },
    "send_out": {
      "type": "boolean"
    },
    "send_to_contact": {
      "$ref": "#/$defs/SendToContact"
    },
    "send_to_elation_user": {
      "description": "If a letter is sent to another elation user, this will be that user's id.",
      "readOnly": true,
      "type": "integer"
    },
    "send_to_name": {
      "maxLength": 200,
      "type": [
        "string",
        "null"
      ]
    },
    "sign_date": {
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "signed_by": {
      "description": "The user who signed the letter.",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    },
    "subject": {
      "description": "The subject of the letter (Not needed with referral_order).",
      "maxLength": 200,
      "type": "string"
    },
    "tags": {
      "description": "A list of Document Tags associated with the letter.",
      "items": {
        "format": "int64",
        "type": "integer"
      },
      "type": "array"
    },
    "to_number": {
      "readOnly": true,
      "type": [
        "string",
        "null"
      ]
    },
    "viewed_at": {
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "with_archive": {
      "type": "boolean"
    }
  },
  "required": [
    "patient",
    "practice",
    "send_to_contact"
  ],
  "type": "object",
  "$defs": {
    "AttachmentTypeEnum": {
      "description": "* `Entity` - Entity\n* `RefPanel` - RefPanel\n* `PatientDemog` - PatientDemog\n* `ImmHistory` - ImmHistory\n* `MedsList` - MedsList\n* `CompMedsList` - CompMedsList\n* `WhoHeightChart` - WhoHeightChart\n* `WhoWeightChart` - WhoWeightChart\n* `WhoHcChart` - WhoHcChart\n* `WhoWflChart` - WhoWflChart\n* `CdcHeightChart` - CdcHeightChart\n* `CdcWeightChart` - CdcWeightChart\n* `CdcBmiChart` - CdcBmiChart\n* `CdcHcChart` - CdcHcChart\n* `PremieHeightChart` - PremieHeightChart\n* `PremieWeightChart` - PremieWeightChart\n* `PremieHcChart` - PremieHcChart\n* `DsinfantHeightChart` - DsinfantHeightChart\n* `DsinfantWeightChart` - DsinfantWeightChart\n* `DsinfantHcChart` - DsinfantHcChart\n* `DsHeightChart` - DsHeightChart\n* `DsWeightChart` - DsWeightChart\n* `DsBmiChart` - DsBmiChart\n* `DsHcChart` - DsHcChart",
      "enum": [
        "Entity",
        "RefPanel",
        "PatientDemog",
        "ImmHistory",
        "MedsList",
        "CompMedsList",
        "WhoHeightChart",
        "WhoWeightChart",
        "WhoHcChart",
        "WhoWflChart",
        "CdcHeightChart",
        "CdcWeightChart",
        "CdcBmiChart",
        "CdcHcChart",
        "PremieHeightChart",
        "PremieWeightChart",
        "PremieHcChart",
        "DsinfantHeightChart",
        "DsinfantWeightChart",
        "DsinfantHcChart",
        "DsHeightChart",
        "DsWeightChart",
        "DsBmiChart",
        "DsHcChart"
      ],
      "type": "string"
    },
    "DeliveryMethodEnum": {
      "enum": [
        "direct",
        "email",
        "emr",
        "fax",
        "passport",
        "printed"
      ],
      "type": "string"
    },
    "LetterAttachment": {
      "properties": {
        "attachment_type": {
          "$ref": "#/$defs/AttachmentTypeEnum"
        },
        "entity_date": {
          "format": "date-time",
          "type": [
            "string",
            "null"
          ]
        },
        "entity_description": {
          "type": [
            "string",
            "null"
          ]
        },
        "entity_id": {
          "format": "int64",
          "type": "integer"
        },
        "entity_type": {
          "readOnly": true,
          "type": [
            "integer",
            "null"
          ]
        },
        "handout": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "id": {
          "readOnly": true,
          "type": "integer"
        },
        "summary": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "attachment_type"
      ],
      "type": "object"
    },
    "SendToContact": {
      "properties": {
        "first_name": {
          "maxLength": 50,
          "type": "string"
        },
        "id": {
          "format": "int64",
          "type": "integer"
        },
        "last_name": {
          "maxLength": 60,
          "type": "string"
        },
        "middle_name": {
          "maxLength": 50,
          "title": "MiddleName",
          "type": "string"
        },
        "npi": {
          "maxLength": 20,
          "type": [
            "string",
            "null"
          ]
        },
        "org_name": {
          "maxLength": 100,
          "type": [
            "string",
            "null"
          ]
        },
        "specialties": {
          "items": {},
          "type": "array"
        }
      },
      "required": [
        "id"
      ],
      "type": "object"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/elation-health-letter"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.