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

# List Histories

> Returns a list of patient histories



## OpenAPI

````yaml get /api/2.0/histories/
openapi: 3.1.0
info:
  contact:
    name: Elation Health
    url: https://www.elationhealth.com/
  description: Elation Health API v2.0
  title: Patient Profile 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/histories/:
    get:
      tags:
        - Histories
      summary: List Histories
      description: Returns a list of patient histories
      operationId: histories_list
      parameters:
        - description: Number of results to return per page.
          in: query
          name: limit
          required: false
          schema:
            type: integer
        - description: The initial index from which to return the results.
          in: query
          name: offset
          required: false
          schema:
            type: integer
        - description: Which field to use when ordering the results.
          in: query
          name: order_by
          required: false
          schema:
            type: string
        - description: Multiple values may be separated by commas.
          explode: false
          in: query
          name: patient
          schema:
            items:
              format: int64
              type: integer
            type: array
          style: form
        - description: Multiple values may be separated by commas.
          explode: false
          in: query
          name: practice
          schema:
            items:
              type: integer
            type: array
          style: form
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedPatientHistoryList'
          description: ''
      security:
        - oauth2: []
components:
  schemas:
    PaginatedPatientHistoryList:
      properties:
        count:
          example: 123
          type: integer
        next:
          example: http://api.example.org/accounts/?offset=400&limit=100
          format: uri
          nullable: true
          type: string
        previous:
          example: http://api.example.org/accounts/?offset=200&limit=100
          format: uri
          nullable: true
          type: string
        results:
          items:
            $ref: '#/components/schemas/PatientHistory'
          type: array
      required:
        - results
      type: object
    PatientHistory:
      properties:
        created_date:
          description: The date the history was created.
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        deleted_date:
          description: The date the history was deleted.
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        id:
          readOnly: true
          type: integer
        patient:
          description: The id of the patient.
          format: int64
          type: integer
        rank:
          description: The rank (or sequence) of the history.
          maximum: 65535
          minimum: 0
          type: integer
        text:
          description: The value (or text) of the history.
          type: string
        type:
          allOf:
            - $ref: '#/components/schemas/PatientHistoryTypeEnum'
          description: The type of the history.
      required:
        - patient
        - text
        - type
      type: object
    PatientHistoryTypeEnum:
      enum:
        - Cognitive Status
        - Consultation
        - Diet
        - Exercise
        - Family
        - Functional Status
        - Habits
        - Health Maintenance
        - Immunization
        - Legal
        - Past
        - Past Surgical
        - Psychological
        - Social
      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

````