> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List all vital readings > Returns a list of vital readings recorded during clinic patient visits. A **vital reading** is a single measurement taken during a clinic patient visit (e.g., weight, temperature, heart rate). Vital readings are grouped together into a reading group that represents all vitals taken at the same time. ## OpenAPI ````yaml get /ext/v2/vital-readings/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/vital-readings/: get: tags: - Medical Records summary: List all vital readings description: >- Returns a list of vital readings recorded during clinic patient visits. A **vital reading** is a single measurement taken during a clinic patient visit (e.g., weight, temperature, heart rate). Vital readings are grouped together into a reading group that represents all vitals taken at the same time. operationId: vital_readings_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`. title: Ending Before - description: >- A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- Filters to vital readings associated with the vital reading group with the given ID. in: query name: vital_reading_group_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filters to vital readings associated with the vital reading group with the given ID. title: Vital Reading Group Id - description: >- Filters to vital readings associated with the patient with the given ID. in: query name: patient_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filters to vital readings associated with the patient with the given ID. title: Patient Id - description: >- Filters to vital readings associated with the medical record with the given ID. in: query name: medical_record_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filters to vital readings associated with the medical record with the given ID. title: Medical Record Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalVitalReadingSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: ExternalVitalReadingSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalVitalReadingSchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: ExternalVitalReadingSchemaList type: object ExternalVitalReadingSchema: properties: created: description: The datetime when this vital was created. format: date-time title: Created type: string id: description: The ID for this vital reading title: Id type: integer medical_record_id: description: The ID of the medical record this vital reading belongs to. title: Medical Record Id type: integer units: anyOf: - $ref: '#/components/schemas/VitalUnitOfMeasure' - const: '' type: string description: The units of measurement for the vital value. title: Units value: description: The value of the vital measurement. title: Value type: string vital_reading_group_id: description: The unique identifier for the vital reading group. title: Vital Reading Group Id type: integer vital_type: description: The type of vital. title: Vital Type type: string required: - id - vital_reading_group_id - medical_record_id - value - units - vital_type - created title: ExternalVitalReadingSchema type: object VitalUnitOfMeasure: enum: - FAHRENHEIT - CELSIUS - POUND - KILOGRAM - GRAM - OUNCE - BPM - SECOND - DENTAL_SCORE_RANGE - FAS_SCORE_RANGE - PAIN_SCORE_RANGE_ONE - PAIN_SCORE_RANGE_TWO - BCS_RANGE_ONE - BCS_RANGE_TWO - MMHG - PERCENT - MILLILITER - MILLILITER_PER_MINUTE - MILLILITER_PER_HOUR - LITER_PER_MINUTE - MCS_SCORE_RANGE_ONE - MCS_SCORE_RANGE_TWO title: VitalUnitOfMeasure type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````