--- title: "GET /udl/evac/history" method: GET path: "/udl/evac/history" tags: ["Mission Ops"] --- # GET /udl/evac/history `GET /udl/evac/history` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/evac/history` - Auth: none declared Service operation to dynamically query historical data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (`/udl//queryhelp`) for more details on valid/required query parameter information. ## Query parameters - `columns` string - `reqTime` string, date-time, required - `firstResult` integer - `maxResults` integer ## Response `200` OK - EvacFull[] - `id` string: Unique identifier of the record, auto-generated by the system. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `medevacId` string: UUID identifying the medevac mission, which should remain the same on subsequent posts related to the same medevac mission. - `type` 'REQUEST' | 'RESPONSE', required: The type of this medevac record (REQUEST, RESPONSE). - `missionType` string: The operation type of the evacuation. (NOT SPECIFIED, AIR, GROUND, SURFACE). - `idWeatherReport` string: Unique identifier of a weather report associated with this evacuation. - `numKIA` integer: Number of people Killed In Action. - `numWIA` integer: Number of people Wounded In Action. - `numLitter` integer: Number of littered personnel requiring evacuation. - `numAmbulatory` integer: Number of ambulatory personnel requiring evacuation. - `medicReq` boolean: Flag indicating whether the mission requires medical personnel. - `reqNum` string: Externally provided Medevac request number (e.g. MED.1.223908). - `reqTime` string, date-time, required: The request time, in ISO 8601 UTC format. - `reqCallSign` string: The call sign of this medevac requestor. - `pickupTime` string, date-time: The expected pickup time, in ISO 8601 UTC format. - `pickupLat` number, double, required: WGS-84 latitude of the pickup location, in degrees. -90 to 90 degrees (negative values south of equator). - `pickupLon` number, double, required: WGS-84 longitude of the pickup location, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `pickupAlt` number, double: Altitude relative to WGS-84 ellipsoid, in meters. Positive values indicate a point height above ellipsoid, and negative values indicate a point height below ellipsoid. - `ce` number, double: Radius of circular area about lat/lon point, in meters (1-sigma, if representing error). - `le` number, double: Height above lat/lon point, in meters (1-sigma, if representing linear error). - `terrain` string: Short description of the terrain features of the pickup location (WOODS, TREES, PLOWED FIELDS, FLAT, STANDING WATER, MARSH, URBAN BUILT-UP AREA, MOUNTAIN, HILL, SAND TD, ROCKY, VALLEY, METAMORPHIC ICE, UNKNOWN TD, SEA, NO STATEMENT). - `obstaclesRemarks` string: Amplifying data for the terrain describing important obstacles in or around the zone. - `terrainRemarks` string: Amplifying data for the terrain describing any notable additional terrain features. - `zoneName` string: The name of the zone. - `zoneMarking` string: The expected marker identifying the pickup site (SMOKE ZONE MARKING, FLARES, MIRROR, GLIDE ANGLE INDICATOR LIGHT, LIGHT ZONE MARKING, PANELS, FIRE, LASER DESIGNATOR, STROBE LIGHTS, VEHICLE LIGHTS, COLORED SMOKE, WHITE PHOSPHERUS, INFRARED, ILLUMINATION, FRATRICIDE FENCE). - `zoneSecurity` string: The pickup site security (UNKNOWN ZONESECURITY, NO ENEMY, POSSIBLE ENEMY, ENEMY IN AREA USE CAUTION, ENEMY IN AREA ARMED ESCORT REQUIRED). - `zoneMarkingColor` string: Color used for the pickup site marking (RED, WHITE, BLUE, YELLOW, GREEN, ORANGE, BLACK, PURPLE, BROWN, TAN, GRAY, SILVER, CAMOUFLAGE, OTHER COLOR). - `zoneHot` boolean: Flag indicating that the pickup site is hot and hostiles are in the area. - `cntctFreq` number, double: The contact frequency, in Hz, of the agency or zone controller. - `zoneContrCallSign` string: The call sign of the zone controller. - `numCasualties` integer: The count of people requiring medevac. - `comments` string: Additional comments for the medevac mission. - `casualtyInfo` EvacCasualtyInfoFull[]: Identity and medical information on the patient to be evacuated. - `priority` string: The priority of the medevac mission for this patient (URGENT, PRIORITY, ROUTINE, URGENT SURGERY, CONVENIENCE). - `evacType` string: The required evacuation method for this patient (AIR, GROUND, NOT EVACUATED). - `casualtyType` string: The type of medical issue resulting in the need to evacuate the patient (NON BATTLE, CUT, BURN, SICK, FRACTURE, AMPUTATION, PERFORATION, NUCLEAR, EXHAUSTION, BIOLOGICAL, CHEMICAL, SHOCK, PUNCTURE WOUND, OTHER CUT, WOUNDED IN ACTION, DENIAL, COMBAT STRESS). - `bodyPart` string: The body part involved for the patient (HEAD, NECK, ABDOMEN, UPPER EXTREMITIES, BACK, FACE, LOWER EXTREMITIES, FRONT, OBSTETRICAL GYNECOLOGICAL, OTHER BODY PART). - `contamType` string: The contamination specified for the patient (NONE, RADIATION, BIOLOGICAL, CHEMICAL). - `specMedEquip` string[]: Array specifying if any special equipment is need for each of the evacuation of this patient (EXTRACTION EQUIPMENT, SEMI RIGID LITTER, BACKBOARD, CERVICAL COLLAR ,JUNGLE PENETRATOR, OXYGEN, WHOLE BLOOD, VENTILATOR, HOIST, NONE). - `casualtyKey` string: Optional casualty key. - `patientStatus` string: The patient service status (US MILITARY, US CIVILIAN, NON US MILITARY, NON US CIVILIAN, ENEMY POW). - `patientIdentity` string: The patient service identity (UNKNOWN MILITARY, UNKNOWN CIVILIAN, FRIEND MILITARY, FRIEND CIVILIAN, NEUTRAL MILITARY, NEUTRAL CIVILIAN, HOSTILE MILITARY, HOSTILE CIVILIAN). - `nationality` string: The country code indicating the citizenship of the patient. - `payGrade` string: The patient pay grade or rank designation (O-10, O-9, O-8, O-7, O-6, O-5, O-4, O-3, O-2, O-1, CWO-5, CWO-4, CWO-2, CWO-1, E -9, E-8, E-7, E-6, E-5, E-4, E-3, E-2, E-1, NONE, CIVILIAN). - `name` string: The patient common or legal name. - `age` integer: The patient age, in years. - `gender` string: The patient sex (MALE, FEMALE). - `last4SSN` string: Last 4 characters of the patient social security code, or equivalent. - `bloodType` string: The patient blood type (A POS, B POS, AB POS, O POS, A NEG, B NEG, AB NEG, O NEG). - `service` string: The patient branch of service (AIR FORCE, ARMY, NAVY, MARINES, CIV, CONTR, UNKNOWN SERVICE). - `callSign` string: The call sign of this patient. - `occSpeciality` string: The career field of this patient. - `burialLocation` number[]: Array of the WGS-84 latitude (-90 to 90, negative values south of the equator) in degrees, longitude (-180 to 180, negative values west of Prime Meridian) in degrees, and altitude, in meters, of the burial location. This array must contain a minimum of 2 elements (latitude and longitude), and may contain an optional 3rd element (altitude). - `collectionPoint` number[]: Array of the WGS-84 latitude (-90 to 90, negative values south of the equator) in degrees, longitude (-180 to 180, negative values west of Prime Meridian) in degrees, and altitude, in meters, of the collection point. This array must contain a minimum of 2 elements (latitude and longitude), and may contain an optional 3rd element (altitude). - `careProviderUrn` string: Unique identifier for the patient care provider. - `dispositionType` string: The expected disposition of this patient (R T D, EVACUATE, EVACUATE TO FORWARD SURGICAL TEAM, EVACUATE TO COMBAT SUPPORT HOSPITAL, EVACUATE TO AERO MEDICAL STAGING FACILITY, EVACUATE TO SUSTAINING BASE MEDICAL TREATMENT FACILITY). - `disposition` string: The patient's general medical state (SICK IN QUARTERS, RETURN TO DUTY, EVACUATE WOUNDED, EVACUATE DECEASED, INTERRED). - `reportGen` string: The method used to generate this medevac report (DEVICE, GROUND COMBAT PERSONNEL, EVACUATION PERSONNEL, ECHELON1 PERSONNEL, ECHELON2 PERSONNEL). - `reportTime` string, date-time: Datetime of the compiling of the patients casualty report, in ISO 8601 UTC format. - `comments` string: Additional comments on the patient's casualty information. - `etiology` EvacEtiologyFull[]: Medical condition causation information. - `type` string: The cause or manner of causation of the medical condition. Intended as, but not constrained to, K07.1 EtiologyType Enumeration (e.g. ASSAULT, BUILDING COLLAPSE, BURN CHEMICAL, BURN ELECTRICAL, BURN, BURN HOT LIQUID, BURN RADIATION, BURN THERMAL, etc.). - `bodyPart` string: The body part or location affected from the etiology. Intended as, but not constrained to, K07.1 Body Location Enumeration (e.g. ANKLE LEFT BACK, ANKLE LEFT FRONT, ANKLE RIGHT BACK, ANKLE RIGHT FRONT, ARM LEFT BACK, ARM LEFT ELBOW BACK, ARM LEFT ELBOW FRONT, ARM LEFT FRONT, ARM LEFT LOWER BACK, etc.). - `time` string, date-time: Datetime of the discovery of the etiology state in ISO 8601 UTC format. - `comments` string: Additional comments on the patient's etiology information. - `treatment` EvacTreatmentFull[]: Treatment information. - `type` string: Type of treatment administered or to be administered. Intended as, but not constrained to, K07.1 Treatment Type Enumeration (e.g. AIRWAY ADJUNCT, AIRWAY ASSISTED VENTILATION, AIRWAY COMBI TUBE USED, AIRWAY ET NT, AIRWAY INTUBATED, AIRWAY NPA OPA APPLIED, AIRWAY PATIENT, AIRWAY POSITIONAL, AIRWAY SURGICAL CRIC, BREATHING CHEST SEAL, BREATHING CHEST TUBE, etc.). - `bodyPart` string: Body part location or body part treated or to be treated. Intended as, but not constrained to, K07.1 Body Location Enumeration (e.g. ANKLE LEFT BACK, ANKLE LEFT FRONT, ANKLE RIGHT BACK, ANKLE RIGHT FRONT, ARM LEFT BACK, ARM LEFT ELBOW BACK, ARM LEFT ELBOW FRONT, ARM LEFT FRONT, ARM LEFT LOWER BACK, etc.). - `time` string, date-time: Datetime of the treatment in ISO 8601 UTC format. - `comments` string: Additional comments on the patient's treatment information. - `vitalSignData` EvacVitalSignDataFull[]: Information obtained for vital signs. - `vitalSign` string: Patient vital sign measured (e.g. HEART RATE, PULSE RATE, RESPIRATION RATE, TEMPERATURE CORE, etc.). - `vitalSign1` number, double: Vital sign value 1. The content of this field is dependent on the type of vital sign being measured (see the vitalSign field). - `vitalSign2` number, double: Vital sign value 2. The content of this field is dependent on the type of vital sign being measured (see the vitalSign field). - `medConfFactor` integer: Medical confidence factor. - `time` string, date-time: Datetime of the vital sign measurement in ISO 8601 UTC datetime format. - `healthState` EvacHealthStateFull[]: Health state information. - `type` string: Generalized state of health type (BIOLOGICAL, CHEMICAL, COGNITIVE, HYDRATION, LIFE SIGN, RADIATION, SHOCK, THERMAL). - `healthStateCode` string: Medical color code used to quickly identify various medical state (e.g. AMBER, BLACK, BLUE, GRAY, NORMAL, RED). - `medConfFactor` integer: Medical confidence factor. - `time` string, date-time: Datetime of the health state diagnosis in ISO 8601 UTC datetime format. - `condition` EvacConditionFull[]: Health condition information. - `type` string: Health condition assessment. Intended as, but not constrained to, K07.1 Condition Type Enumeration (e.g. ACTIVITY HIGH, ACTIVITY LOW, ACTIVITY MEDIUM, ACTIVITY NONE, AVPU ALERT, AVPU ALTERED MENTAL STATE, AVPU PAIN, AVPU UNRESPONSIVE, etc.). - `bodyPart` string: Body part location or body part referenced in condition. Intended as, but not constrained to, K07.1 Body Location Enumeration (e.g. ANKLE LEFT BACK, ANKLE LEFT FRONT, ANKLE RIGHT BACK, ANKLE RIGHT FRONT, ARM LEFT BACK, ARM LEFT ELBOW BACK, ARM LEFT ELBOW FRONT, ARM LEFT FRONT, ARM LEFT LOWER BACK, etc.). - `time` string, date-time: Datetime of the condition diagnosis in ISO 8601 UTC datetime format. - `comments` string: Additional comments on the patient's condition. - `medication` EvacMedicationFull[]: Medication specifics. - `type` string: The type of medication administered. Intended as, but not constrained to, K07.1 Medication Enumeration (CEFOTETAN, ABRASION, ABX, AMOXILOXACIN, ANALGESIC, COLLOID, CRYOPECIPITATES, CRYSTALLOID, EPINEPHRINE, ERTAPENEM, FENTANYL, HEXTEND, LACTATED RINGERS, MOBIC, MORPHINE, NARCOTIC, NS, PENICILLIN, PLASMA, PLATELETS, PRBC, TYLENOL, WHOLE BLOOD MT). - `bodyPart` string: Body part location or body part referenced for medication. Intended as, but not constrained to, K07.1 Body Location Enumeration (e.g. ANKLE LEFT BACK, ANKLE LEFT FRONT, ANKLE RIGHT BACK, ANKLE RIGHT FRONT, ARM LEFT BACK, ARM LEFT ELBOW BACK, ARM LEFT ELBOW FRONT, ARM LEFT FRONT, ARM LEFT LOWER BACK, etc.). - `dose` string: Quantity of medicine or drug administered or recommended to be taken at a particular time. - `adminRoute` string: Route of medication delivery (e.g. INJECTION, ORAL, etc.). - `time` string, date-time: The time that the medication was administered in ISO 8601 UTC format. - `comments` string: Additional comments on the patient's medication information. - `injury` EvacInjuryFull[]: Injury specifics. - `type` string: Classification of the injury type (ABRASION, AMPUTATION IT, AVULATION, BALLISTIC, BLAST WAVE, BURN 1ST DEGREE, BURN 2ND DEGREE, BURN 3RD DEGREE, BURN INHALATION, BURN LOWER AIRWAY, CHEST FLAIL, CHEST OPEN, DEGLOVING, ECCHYMOSIS, FRACTURE CLOSED, FRACTURE CREPITUS, FRACTURE IT, FRACTURE OPEN, HEMATOMA, IRREGULAR CONSISTENCY, IRREGULAR CONSISTENCY RIDGED, IRREGULAR CONSISTENCY SWOLLEN, IRREGULAR CONSISTENCY SWOLLEN DISTENDED, IRREGULAR CONSISTENCY TENDER, IRREGULAR POSITION, IRREGULAR SHAPE, IRREGULAR SHAPE MISSHAPED, IRREGULAR SHAPE NON SYMMETRICAL, LACERATION, NEUROVASCULAR COMPROMISE, NEUROVASCULAR INTACT, PUNCTURE, SEAT BELT SIGN, STAB, TIC TIM). - `bodyPart` string: Body part location of the injury. Intended as, but not constrained to, K07.1 Body Location Enumeration (e.g. ANKLE LEFT BACK, ANKLE LEFT FRONT, ANKLE RIGHT BACK, ANKLE RIGHT FRONT, ARM LEFT BACK, ARM LEFT ELBOW BACK, ARM LEFT ELBOW FRONT, ARM LEFT FRONT, ARM LEFT LOWER BACK, etc.). - `time` string, date-time: The time of the injury, in ISO 8601 UTC format. - `comments` string: Additional comments on the patient's injury information. - `allergy` EvacAllergyFull[]: Allergy information. - `type` string: Type of patient allergy (e.g. PENICILLIN, SULFA, OTHER). - `comments` string: Additional comments on the patient's allergy information. - `enemyData` EvacEnemyDataFull[]: Data defining any enemy intelligence reported by the requestor. - `dirToEnemy` string: Directions to known enemies in the operation area (NORTH, NORTHEAST, EAST, SOUTHEAST, SOUTH, SOUTHWEST, WEST, NORTHWEST, SURROUNDED). - `hostileFireType` string: The type of hostile fire received (SMALL ARMS, MORTAR, ARTILLERY, ROCKETS). - `friendliesRemarks` string: Comments provided by friendlies about the evac zone. - `hlzRemarks` string: Hot Landing Zone remarks. - `relatedDocs` RelatedDocumentFull[]: Related document ids. - `documentId` string: The document id of the related document. - `dataSourceRefs` SofDataSourceRefFull[]: List of data sources related to this document. - `dataSourceId` string: Data source id. - `startPosition` string: start position. - `endPosition` string: end position. - `paragraphNumber` string: paragraph number. - `sentenceNumber` string: sentence number. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system. - `createdBy` string: Application user who created the row in the database, auto-populated by the system. - `source` string, required: Source of the data. - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin. - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets. ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2026-03-25** `173e4aff893f`: 2 breaking - the `items/casualtyInfo/items/burialLocation` response property's minItems was decreased from `2` to `0` for the response status `200` - the `items/casualtyInfo/items/collectionPoint` response property's minItems was decreased from `2` to `0` for the response status `200` - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 1 breaking, 2 info - the `items/casualtyInfo/items/specMedEquip/items/` response property's maxLength was unset from `32` for the response status `200` - api operation id `findAllHistory_21` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/evac/history/get.md) --- [API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)