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

# Retrieve Patient Letter

> Retrieve a single patient letter.



## OpenAPI

````yaml get /api/2.0/patient_letters/{id}/
openapi: 3.1.0
info:
  contact:
    name: Elation Health
    url: https://www.elationhealth.com/
  description: Elation Health API v2.0
  title: Elation Health API
  version: 2.0.0
servers:
  - description: Sandbox Server
    url: https://sandbox.elationemr.com
  - description: Production Server
    url: https://api.app.elationemr.com
security: []
paths:
  /api/2.0/patient_letters/{id}/:
    get:
      tags:
        - Patient Letters (BETA)
      summary: Retrieve Patient Letter
      description: Retrieve a single patient letter.
      operationId: patient_letters_retrieve
      parameters:
        - in: path
          name: id
          required: true
          schema:
            format: int64
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatientLetter'
          description: ''
      security:
        - oauth2: []
components:
  schemas:
    PatientLetter:
      properties:
        attachments:
          items:
            $ref: '#/components/schemas/LetterAttachment'
          type: array
        body:
          type: string
        category:
          format: int64
          readOnly: true
          type:
            - integer
            - 'null'
        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'
        document_date:
          format: date-time
          type: string
        files:
          description: >-
            Files attached to this letter. Binary upload: set
            content_type='application/octet-stream' and provide 'base64_content'
            (and optional 'original_filename'). When any file uses base64, all
            files in the same request must use base64. On GET, returns file
            references.
          items:
            $ref: '#/components/schemas/S3RetrievingDocumentFile'
          type:
            - array
            - 'null'
        id:
          readOnly: true
          type: integer
        is_patient_initiated:
          type:
            - boolean
            - 'null'
        is_processed:
          readOnly: true
          type: boolean
        letter_type:
          readOnly: true
          type: string
        patient:
          format: int64
          type: integer
        patient_read_time:
          format: date-time
          type:
            - string
            - 'null'
        practice:
          format: int64
          type: integer
        send_out:
          type: boolean
        send_to_patient:
          readOnly: true
          type: boolean
        sign_date:
          format: date-time
          type:
            - string
            - 'null'
        signed_by:
          description: The user who signed the letter.
          format: int64
          type:
            - integer
            - 'null'
        subject:
          maxLength: 200
          type: string
        tags:
          description: A list of Document Tags associated with the letter.
          items:
            format: int64
            type: integer
          type: array
        viewed_at:
          format: date-time
          type:
            - string
            - 'null'
      required:
        - patient
        - practice
      type: object
    LetterAttachment:
      properties:
        attachment_type:
          $ref: '#/components/schemas/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
    S3RetrievingDocumentFile:
      properties:
        base64_content:
          type: string
        content_type:
          type: string
        document:
          description: URL to retrieve the document
          format: uri
          type: string
        external_content: {}
        id:
          readOnly: true
          type: integer
        original_filename:
          type: string
      type: object
    AttachmentTypeEnum:
      description: |-
        * `Entity` - Entity
        * `RefPanel` - RefPanel
        * `PatientDemog` - PatientDemog
        * `ImmHistory` - ImmHistory
        * `MedsList` - MedsList
        * `CompMedsList` - CompMedsList
        * `WhoHeightChart` - WhoHeightChart
        * `WhoWeightChart` - WhoWeightChart
        * `WhoHcChart` - WhoHcChart
        * `WhoWflChart` - WhoWflChart
        * `CdcHeightChart` - CdcHeightChart
        * `CdcWeightChart` - CdcWeightChart
        * `CdcBmiChart` - CdcBmiChart
        * `CdcHcChart` - CdcHcChart
        * `PremieHeightChart` - PremieHeightChart
        * `PremieWeightChart` - PremieWeightChart
        * `PremieHcChart` - PremieHcChart
        * `DsinfantHeightChart` - DsinfantHeightChart
        * `DsinfantWeightChart` - DsinfantWeightChart
        * `DsinfantHcChart` - DsinfantHcChart
        * `DsHeightChart` - DsHeightChart
        * `DsWeightChart` - DsWeightChart
        * `DsBmiChart` - DsBmiChart
        * `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
  securitySchemes:
    oauth2:
      flows:
        clientCredentials:
          scopes:
            act_as_user: >-
              Impersonate a provider via X-On-Behalf-Of (combinable with apiv2
              or system scopes)
            apiv2: Full access to the API
            system/{resource_name}.read: Read access to a specific resource
            system/{resource_name}.write: Write access to a specific resource
          tokenUrl: /api/2.0/oauth2/token/
      type: oauth2

````