{"openapi":"3.0.1","info":{"title":"VA Facilities","description":"## Background\n\nThe VA Facilities API version 0 (v0) provides information about VA facilities, including locations, addresses, phone numbers, hours of operation, and available services.\n\nThis API gives information about several types of VA facilities:\n- Health facilities (vha)\n- Benefits facilities (vba)\n- Cemeteries (nca)\n- Vet Centers (vc)\n\n## Technical overview\n\nFor in-depth details on data sources for the Facilities API, [read our Facilities GitHub documentation](https://github.com/department-of-veterans-affairs/lighthouse-facilities#readme).\n\nHealth service and service availability data for v0 of this API are based on historical data.\n\n- Historical data is returned for the previous 30 days.\n- Data is based on both pending and completed appointments for a service at a given facility.\n\n\n### Authentication and Authorization\n\nAPI requests are authorized througha symmetric API token provided in an HTTP header named apikey.\n\n### Test data\n\nTest data for the sandbox environment is only for testing the API and is not guaranteed to be up-to-date. After testing this API in sandbox, you can start the process of moving to production.\n\n### Facility ID formats\n\nA facility ID has the format prefix_stationNumber. The prefix is nca, vc, vba, or vha. Cemeteries may be VA national cemeteries or non-national; non-national cemeteries have the station number prefixed with an s. There are no other constraints on the format. Some facility ID examples are:\n- Health: `vha_402GA`\n- Benefits: `vba_539GB`\n- National cemetery: `nca_063`\n- Non-national cemetery: `nca_s1082`\n- Vet Center: `vc_0872MVC`\n\n\n### Mobile facilities\n\nThe mobile health facilities move regularly within a region. If a facility comes back from this API with \"mobile\": \"true\", the latitude/longitude and address could be inaccurate. To get the exact current location, please call the mobile facility number listed.","contact":{"name":"developer.va.gov"},"version":"0.0.1"},"tags":[{"name":"facilities","description":"VA Facilities API"}],"paths":{"/facilities/all":{"get":{"tags":["facilities"],"summary":"Bulk download information for all facilities","description":"Retrieve all available facilities in a single operation, formatted as either a GeoJSON FeatureCollection or as a CSV. Due to the complexity of the facility resource type, the CSV response contains a subset of available facility data - specifically it omits the available services, patient satisfaction, and patient wait time data.","operationId":"GET:/facilities/all","parameters":[{"name":"Accept","in":"header","required":true,"schema":{"type":"string","enum":["application/geo+json","application/vnd.geo+json","text/csv"]},"example":"application/geo+json"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeoFacilitiesResponse"}},"application/geo+json":{"schema":{"$ref":"#/components/schemas/GeoFacilitiesResponse"}},"application/vnd.geo+json":{"schema":{"$ref":"#/components/schemas/GeoFacilitiesResponse"}},"text/csv":{"schema":{"type":"string","example":"id,name,station_id,latitude,longitude,facility_type,classification,website,physical_address_1,physical_address_2,physical_address_3,physical_city,physical_state,physical_zip,mailing_address_1,mailing_address_2,mailing_address_3,mailing_city,mailing_state,mailing_zip,phone_main,phone_fax,phone_mental_health_clinic,phone_pharmacy,phone_after_hours,phone_patient_advocate,phone_enrollment_coordinator,hours_monday,hours_tuesay,hours_wednesday,hours_thursday,hours_friday,hours_saturday,hours_sunday,mobile,active_status,visn\nvc_0101V,Boston Vet Center,0101V,42.3445959000001,-71.0361051099999,vet_center,,,7 Drydock Avenue,Suite 2070,,Boston,MA,2210,,,,,,,857-203-6461 x,,,,,,,800AM-700PM,800AM-800PM,800AM-700PM,800AM-800PM,800AM-600PM,-,-,,,\nvba_362b,Houston Regional Benefit Office at Frank Tejeda Outpatient Clinic,362b,29.51690196,-98.59601936,va_benefits_facility,Outbased,NULL,5788 Eckhert Road,,,San Antonio,TX,78240,,,,,,,210-699-5040,210-699-5079,,,,,,,,,,,,,,,\nvha_459GH,Saipan VA Clinic,459GH,15.216794,145.729385,va_health_facility,Other Outpatient Services (OOS),,Marina Heights Business Park - Garapan,Medical Associates of the Pacific,MH-II Building Suite 100 and 206,Saipan,MP,96950-9998,,,,,,,670-322-0035 x,670-322-0038 x,\"\",800-465-8387 x,800-214-1306 x,670-322-0035 x,808-433-7600 x,,,,,,,,false,A,21\n"}}}},"401":{"description":"Authorization information not provided","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"No API key found in request"}}}}},"403":{"description":"Invalid authorization","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"You cannot consume this service"}}}}},"406":{"description":"Requested format unacceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"Request size limit exceeded"}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"API rate limit exceeded"}}}}}}}},"/facilities":{"get":{"tags":["facilities"],"summary":"Query facilities by location or IDs, with optional filters","description":"Query facilities by bounding box, latitude and longitude, state, visn, or zip code. Bounding box is specified as four `bbox[]` parameters, long1, lat1, long2, lat2. (Relative order is unimportant.)\n\nA query by latitude and longitude returns all facilities in the system, sorted by distance from that location. Providing an optional radius in miles to this query will narrow the scope of the returned facilities to those falling within the specified radius from that location.\n\nAll location queries support filtering by facility type, available services, and mobile status.\n\nOne can also retrieve facilities by ID using a comma-separated list like `?ids=id1,id2`. When requesting multiple facilities by ID, the API will return as many results as it can find matches for, omitting IDs where there is no match. It will not return an HTTP error code if it is unable to match a requested ID. Clients may supply IDs up to the limit their HTTP client enforces for URI path lengths. (Usually 2048 characters.)\n\nResults are paginated. JSON responses include pagination information in the standard JSON API \"links\" and \"meta\" elements. \n\n### Parameter combinations\nYou may optionally specify `page` and `per_page` with any query. You must specify one of the following parameter combinations: \n\n- `bbox[]`, with the option of any combination of `type`, `services[]`, or `mobile`\n\n- `ids`\n\n- `lat` and `long`, with the option of any combination of `radius`, `ids`, `type`, `services[]`, or `mobile`\n\n- `state`, with the option of any combination of `type`, `services[]`, or `mobile`\n\n- `visn`\n\n- `zip`, with the option of any combination of `type`, `services[]`, or `mobile`\n\n Invalid combinations will return `400 Bad Request`. ","operationId":"GET:/facilities","parameters":[{"name":"ids","in":"query","description":"List of comma-separated facility IDs to retrieve in a single request. Can be combined with lat and long parameters to retrieve facilities sorted by distance from a location.","style":"form","schema":{"type":"array","items":{"type":"string"}},"examples":{"ids":{"description":"ids","value":["vha_688","vha_644"]}}},{"name":"zip","in":"query","description":"Zip code to search for facilities. More detailed zip codes can be passed in, but only the first five digits are used to determine facilities to return.","schema":{"type":"string","format":"##### or #####-####"},"examples":{"zip":{"description":"zip","value":"80301-1000"}}},{"name":"state","in":"query","description":"State in which to search for facilities. Except in rare cases, this is two characters.","schema":{"type":"string","format":"XX"},"examples":{"state":{"description":"state","value":"CO"}}},{"name":"lat","in":"query","description":"Latitude of point to search for facilities, in WGS84 coordinate reference system.","schema":{"type":"number","format":"float"},"examples":{"coordinates":{"description":"coordinates","value":56.7}}},{"name":"long","in":"query","description":"Longitude of point to search for facilities, in WGS84 coordinate reference system.","style":"form","schema":{"type":"number","format":"float"},"examples":{"coordinates":{"description":"coordinates","value":-123.4}}},{"name":"radius","in":"query","description":"Optional radial distance from specified latitude and longitude to filter facilities search in WGS84 coordinate reference system.","style":"form","schema":{"type":"number","format":"float"},"examples":{"distance":{"description":"distance","value":75}}},{"name":"bbox[]","in":"query","description":"Bounding box (longitude, latitude, longitude, latitude) within which facilities will be returned. (WGS84 coordinate reference system)","style":"form","schema":{"maxItems":4,"minItems":4,"type":"array","items":{"type":"number","format":"float"}},"examples":{"bbox":{"description":"bbox","value":[-105.4,39.4,-104.5,40.1]}}},{"name":"visn","in":"query","description":"VISN search of matching facilities.","schema":{"type":"number"}},{"name":"type","in":"query","description":"Optional facility type search filter","schema":{"type":"string","enum":["health","cemetery","benefits","vet_center"]}},{"name":"services[]","in":"query","description":"Optional facility service search filter","style":"form","schema":{"type":"array","items":{"type":"string"}}},{"name":"mobile","in":"query","description":"Optional facility mobile search filter","schema":{"type":"boolean"}},{"name":"page","in":"query","description":"Page of results to return per paginated response.","schema":{"type":"integer","format":"int64","default":1}},{"name":"per_page","in":"query","description":"Number of results to return per paginated response.","schema":{"type":"integer","format":"int64","default":10}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacilitiesResponse"}},"application/geo+json":{"schema":{"$ref":"#/components/schemas/GeoFacilitiesResponse"}},"application/vnd.geo+json":{"schema":{"$ref":"#/components/schemas/GeoFacilitiesResponse"}}}},"401":{"description":"Authorization information not provided","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"No API key found in request"}}}}},"403":{"description":"Invalid authorization","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"You cannot consume this service"}}}}},"406":{"description":"Requested format unacceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"Request size limit exceeded"}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"API rate limit exceeded"}}}}}}}},"/facilities/{id}":{"get":{"tags":["facilities"],"summary":"Retrieve a specific facility by ID","operationId":"GET:/facilities/{id}","parameters":[{"name":"id","in":"path","description":"Facility ID, in the form `<prefix>_<station>`, where prefix is one of \"vha\", \"vba\", \"nca\", or \"vc\", for health facility, benefits, cemetery, or vet center, respectively.","required":true,"schema":{"type":"string"},"example":"vha_688"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacilityReadResponse"}},"application/geo+json":{"schema":{"$ref":"#/components/schemas/GeoFacilityReadResponse"}},"application/vnd.geo+json":{"schema":{"$ref":"#/components/schemas/GeoFacilityReadResponse"}}}},"400":{"description":"Bad request - invalid or missing query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Authorization information not provided","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"No API key found in request"}}}}},"403":{"description":"Invalid authorization","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"You cannot consume this service"}}}}},"404":{"description":"Facility not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"406":{"description":"Requested format unacceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"Request size limit exceeded"}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"API rate limit exceeded"}}}}}}}},"/ids":{"get":{"tags":["facilities"],"summary":"Bulk download of all facility IDs","description":"Retrieves all available facility IDs only","operationId":"GET:/ids","parameters":[{"name":"type","in":"query","description":"Optional facility type search filter","schema":{"type":"string","enum":["health","cemetery","benefits","vet_center"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacilitiesIdsResponse"}}}},"401":{"description":"Authorization information not provided","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"No API key found in request"}}}}},"403":{"description":"Invalid authorization","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"You cannot consume this service"}}}}},"406":{"description":"Requested format unacceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"Request size limit exceeded"}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"API rate limit exceeded"}}}}}}}},"/nearby":{"get":{"tags":["facilities"],"summary":"Retrieve all VA health facilities reachable by driving within the specified time period","description":"Retrieve all VA health facilities that are located within a specified drive time from a specified location based on coordinates (lat and lng). Optional filter parameters include drive_time and services[]. Address (street_address, city, state, and zip) no longer returns results.\n\nThe \"attributes\" element has information about the drive-time band that contains the requested location for each facility in the response. The values of `min_time` and `max_time` are in minutes. For example, a facility returned with a matched `min_time` of 10 and `max_time` of 20 is a 10 to 20 minute drive from the requested location.\n\nTo retrieve full details for nearby facilities, see the documentation for `/facilities?ids`.","operationId":"GET:/nearby","parameters":[{"name":"lat","in":"query","description":"Latitude of the location from which drive time will be calculated.","schema":{"type":"number","format":"float"},"examples":{"coordinates":{"description":"coordinates","value":56.7}}},{"name":"lng","in":"query","description":"Longitude of the location from which drive time will be calculated.","style":"form","schema":{"type":"number","format":"float"},"examples":{"coordinates":{"description":"coordinates","value":-123.4}}},{"name":"street_address","in":"query","description":"Street address of the location from which drive time will be calculated.","schema":{"type":"string"},"examples":{"address":{"description":"address","value":"1350 I St. NW"}}},{"name":"city","in":"query","description":"City of the location from which drive time will be calculated.","schema":{"type":"string"},"examples":{"address":{"description":"address","value":"Washington"}}},{"name":"state","in":"query","description":"Two character state code of the location from which drive time will be calculated.","schema":{"type":"string"},"examples":{"address":{"description":"address","value":"DC"}}},{"name":"zip","in":"query","description":"Zip code of the location from which drive time will be calculated.","schema":{"type":"string","description":"##### or #####-####"},"examples":{"address":{"description":"address","value":"20005-3305"}}},{"name":"drive_time","in":"query","description":"Filter to only include facilities that are within the specified number of drive time minutes from the requested location.","schema":{"type":"integer","format":"int32","default":90,"enum":[10,20,30,40,50,60,70,80,90]}},{"name":"services[]","in":"query","description":"Optional facility service search filter","style":"form","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NearbyResponse"}}}},"400":{"description":"Missing Required Or Ambiguous Parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericError"}}}},"401":{"description":"Authorization information not provided","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"No API key found in request"}}}}},"403":{"description":"Invalid authorization","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"You cannot consume this service"}}}}},"406":{"description":"Requested format unacceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"Request size limit exceeded"}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"API rate limit exceeded"}}}}}}}}},"components":{"schemas":{"Address":{"type":"object","properties":{"zip":{"type":"string","description":"Postal (ZIP) code.","nullable":true,"example":"20422-0001"},"city":{"type":"string","description":"City name.","nullable":true,"example":"Washington"},"state":{"type":"string","description":"State code.","nullable":true,"example":"DC"},"address_1":{"type":"string","description":"Street name and number.","nullable":true,"example":"50 Irving Street, Northwest"},"address_2":{"type":"string","description":"Second line of address if applicable (such as a building number).","nullable":true,"example":"Bldg 2"},"address_3":{"type":"string","description":"Third line of address if applicable (such as a unit or suite number).","nullable":true,"example":"Suite 7"}},"description":"Description of an address.","nullable":true},"Addresses":{"type":"object","properties":{"mailing":{"$ref":"#/components/schemas/Address"},"physical":{"$ref":"#/components/schemas/Address"}},"description":"Collection of addresses associated with a facility.","nullable":true},"AppointmentPhoneNumber":{"type":"object","properties":{"extension":{"type":"string","description":"Appointment phone number extension.","nullable":true,"example":"71234"},"label":{"type":"string","description":"Appointment phone number label (e.g. 'Main phone', 'Appointment phone', etc).","nullable":true,"example":"Main phone"},"number":{"type":"string","description":"Appointment phone number.","nullable":true,"example":"937-268-6511"},"type":{"type":"string","description":"Appointment contact number type (e.g. 'tel', 'fax', etc)","nullable":true,"example":"tel"}},"description":"Phone number information for scheduling an appointment.","nullable":true},"DetailedService":{"type":"object","properties":{"service_id":{"type":"string","description":"Service id.","example":"covid19Vaccine"},"name":{"type":"string","description":"Service name.","nullable":true,"example":"COVID-19 vaccines"},"description_facility":{"type":"string","description":"Deprecated until further notice.","nullable":true,"example":"null"},"appointment_leadin":{"type":"string","description":"Additional appointment information. May contain html / string formatting characters.","nullable":true,"example":"Your VA health care team will contact you if you're eligible to get a vaccine during this time. As the supply of vaccine increases, we'll work with our care teams to let Veterans know their options."},"appointment_phones":{"type":"array","description":"List of phone numbers related to scheduling appointments for this service.","nullable":true,"items":{"$ref":"#/components/schemas/AppointmentPhoneNumber"}},"online_scheduling_available":{"type":"string","description":"String detailing online scheduling availability.","nullable":true,"example":"True"},"referral_required":{"type":"string","description":"String detailing if referrals are required for the service.","nullable":true,"example":"False"},"walk_ins_accepted":{"type":"string","description":"String detailing if walk-ins are accepted for the service.","nullable":true,"example":"True"},"service_locations":{"type":"array","deprecated":true,"items":{"$ref":"#/components/schemas/DetailedServiceLocation"}},"last_updated":{"type":"string","description":"Date and time of most recent upload of detailed service from CMS.","format":"date-time","nullable":true},"path":{"type":"string","description":"URL to a page with additional details for this service within the associated facility's health care system.","nullable":true,"example":"https://www.boston.va.gov/services/covid-19-vaccines.asp"}},"description":"Detailed information of a facility service.","nullable":true},"DetailedServiceAddress":{"type":"object","properties":{"building_name_number":{"type":"string","description":"Building name and/or number of service.","nullable":true,"example":"Baxter Building"},"wing_floor_or_room_number":{"type":"string","description":"Wing, floor, or room number of service.","nullable":true,"example":"Wing East"},"address_line1":{"type":"string","description":"Street name and number.","nullable":true,"example":"50 Irving Street, Northwest"},"address_line2":{"type":"string","description":"Building number.","nullable":true,"example":"Bldg 2"},"city":{"type":"string","description":"City name.","nullable":true,"example":"Washington"},"state":{"type":"string","description":"State code.","nullable":true,"example":"DC"},"zip_code":{"type":"string","description":"Postal (ZIP) code.","nullable":true,"example":"20422-0001"},"country_code":{"type":"string","description":"Country code.","nullable":true,"example":"US"}},"description":"Service location address.","nullable":true},"DetailedServiceEmailContact":{"type":"object","properties":{"email_address":{"type":"string","description":"Email address for facility service contact.","nullable":true,"example":"georgea@va.gov"},"email_label":{"type":"string","description":"Email address label.","nullable":true,"example":"George Anderson"}},"description":"Email contact information for facility service.","nullable":true},"DetailedServiceHours":{"type":"object","properties":{"Monday":{"type":"string","description":"Service availability on Mondays.","nullable":true,"example":"9AM-5PM"},"Tuesday":{"type":"string","description":"Service availability on Tuesdays.","nullable":true,"example":"9AM-5PM"},"Wednesday":{"type":"string","description":"Service availability on Wednesdays.","nullable":true,"example":"9AM-5PM"},"Thursday":{"type":"string","description":"Service availability on Thursdays.","nullable":true,"example":"9AM-5PM"},"Friday":{"type":"string","description":"Service availability on Fridays.","nullable":true,"example":"9AM-5PM"},"Saturday":{"type":"string","description":"Service availability on Saturdays.","nullable":true,"example":"Closed"},"Sunday":{"type":"string","description":"Service availability on Sundays.","nullable":true,"example":"Closed"}},"description":"Standard hours of operation. Currently formatted as descriptive text suitable for display, with no guarantee of a standard parseable format. Hours of operation may vary due to holidays or other events.","nullable":true},"DetailedServiceLocation":{"type":"object","properties":{"email_contacts":{"type":"array","description":"List of email contact information regarding facility services.","nullable":true,"items":{"$ref":"#/components/schemas/DetailedServiceEmailContact"}},"additional_hours_info":{"type":"string","description":"Additional information related to service location hours.","nullable":true,"example":"Location hours times may vary depending on staff availability"},"service_hours":{"$ref":"#/components/schemas/DetailedServiceHours"},"phones":{"type":"array","description":"List of appointment phone information.","nullable":true,"items":{"$ref":"#/components/schemas/AppointmentPhoneNumber"}},"walk_ins_accepted":{"type":"string","description":"String detailing if walk-ins are accepted for the service.","nullable":true,"example":"True"},"online_scheduling_available":{"type":"string","description":"String detailing online scheduling availability.","nullable":true,"example":"True"},"referral_required":{"type":"string","description":"String detailing if referrals are required for the service.","nullable":true,"example":"False"},"office_name":{"type":"string","description":"Name of given office location.","nullable":true,"example":"ENT Clinic"},"service_address":{"$ref":"#/components/schemas/DetailedServiceAddress"}},"description":"Details for a location offering a service.","nullable":true,"deprecated":true},"GeoFacilitiesResponse":{"required":["type"],"type":"object","properties":{"type":{"type":"string","enum":["FeatureCollection"]},"features":{"type":"array","items":{"$ref":"#/components/schemas/GeoFacility"}}},"description":"GeoJSON API-compliant response object describing one or more VA facilities."},"GeoFacility":{"required":["geometry","properties","type"],"type":"object","properties":{"type":{"type":"string","description":"Top level category describing the type of facility.","example":"Feature","enum":["Feature"]},"geometry":{"$ref":"#/components/schemas/Geometry"},"properties":{"$ref":"#/components/schemas/Properties"}},"description":"GeoJSON-complaint Feature object describing a VA Facility"},"Geometry":{"required":["type"],"type":"object","properties":{"type":{"type":"string","description":"Describes the type of geometric data provided.","example":"Point","enum":["Point"]},"coordinates":{"type":"array","description":"The latitude and longitude of the Facility's physical location.","nullable":true,"example":[-77.0367761,38.9004181],"items":{"type":"number","description":"The latitude and longitude of the Facility's physical location.","nullable":true}}},"description":"Geometric data giving the physical location of a VA Facility.","nullable":true},"Hours":{"type":"object","properties":{"monday":{"type":"string","description":"Hours of operation for Monday.","nullable":true,"example":"9AM-5PM"},"tuesday":{"type":"string","description":"Hours of operation for Tuesday.","nullable":true,"example":"9AM-5PM"},"wednesday":{"type":"string","description":"Hours of operation for Wednesday.","nullable":true,"example":"9AM-5PM"},"thursday":{"type":"string","description":"Hours of operation for Thursday.","nullable":true,"example":"9AM-5PM"},"friday":{"type":"string","description":"Hours of operation for Friday.","nullable":true,"example":"9AM-5PM"},"saturday":{"type":"string","description":"Hours of operation for Saturday.","nullable":true,"example":"Closed"},"sunday":{"type":"string","description":"Hours of operation for Sunday.","nullable":true,"example":"Closed"}},"description":"Standard hours of operation. Currently formatted as descriptive text suitable for display, with no guarantee of a standard parseable format. Hours of operation may vary due to holidays or other events.","nullable":true,"example":"\"monday\": \"9:30AM-4:00PM\","},"OperatingStatus":{"required":["code"],"type":"object","properties":{"code":{"type":"string","description":"Status codes indicate normal hours/services, limited hours/services, closed operations, or published facility notices for visitors.","nullable":true,"example":"NORMAL","enum":["NORMAL","NOTICE","LIMITED","CLOSED"]},"additional_info":{"type":"string","description":"Details of facility notices for visitors, such as messages about parking lot closures or floor visitation information.","nullable":true},"supplemental_status":{"type":"array","description":"List of supplemental statuses for VA facility.","nullable":true,"items":{"$ref":"#/components/schemas/SupplementalStatus"}}},"description":"Current status of facility operations. The overall status of the facility, which can be: Normal Hours and Services, Facility Notice, Limited Hours and/or Services, or Closed. This field replaces active_status.","nullable":true,"example":"NORMAL"},"PatientSatisfaction":{"type":"object","properties":{"primary_care_urgent":{"type":"number","description":"Percentage of Veterans who say they usually or always get an appointment when they need urgent attention at a primary care location. NOTE: Veterans are rating their satisfaction of getting an appointment for an urgent primary care visit, NOT an urgent care visit.","format":"float","nullable":true,"example":0.85},"primary_care_routine":{"type":"number","description":"Percentage of Veterans who say they usually or always get an appointment when they need routine attention at a primary care location. NOTE: Veterans are rating their satisfaction of getting an appointment for a routine primary care visit.","format":"float","nullable":true,"example":0.85},"specialty_care_urgent":{"type":"number","description":"Percentage of Veterans who say they usually or always get an appointment when they need urgent attention at a specialty care location. NOTE: Veterans are rating their satisfaction of getting an appointment for an urgent specialty care visit, NOT an urgent care visit.","format":"float","nullable":true,"example":0.85},"specialty_care_routine":{"type":"number","description":"Percentage of Veterans who say they usually or always get an appointment when they need routine attention at a specialty care location. NOTE: Veterans are rating their satisfaction of getting an appointment for a routine specialty care visit.","format":"float","nullable":true,"example":0.85}},"description":"Veteran-reported satisfaction score for health care services at VA health facilities.","nullable":true},"PatientWaitTime":{"required":["service"],"type":"object","properties":{"service":{"type":"string","description":"Service being offered by facility.","enum":["Audiology","Cardiology","CaregiverSupport","Covid19Vaccine","DentalServices","Dermatology","EmergencyCare","Gastroenterology","Gynecology","MentalHealthCare","Ophthalmology","Optometry","Orthopedics","Nutrition","Podiatry","PrimaryCare","SpecialtyCare","UrgentCare","Urology","WomensHealth"]},"new":{"type":"number","description":"Average number of days a Veteran who hasn't been to this location has to wait for a non-urgent appointment.","nullable":true,"example":10},"established":{"type":"number","description":"Average number of days a patient who has already been to this location has to wait for a non-urgent appointment.","nullable":true,"example":5}},"description":"Expected wait times for new and established patients for a given health care service at VA health facilities.","nullable":true},"Phone":{"type":"object","properties":{"fax":{"type":"string","description":"Phone number used for faxing to given facility.","nullable":true,"example":"202-555-1212"},"main":{"type":"string","description":"Phone number for given facility.","nullable":true,"example":"202-555-1212"},"pharmacy":{"type":"string","description":"Phone number for pharmacy for given facility.","nullable":true,"example":"202-555-1212"},"after_hours":{"type":"string","description":"Phone number that may be reached outside of operating hours for given facility.","nullable":true,"example":"202-555-1212"},"patient_advocate":{"type":"string","description":"Phone number for patient advocate for given facility.","nullable":true,"example":"202-555-1212"},"mental_health_clinic":{"type":"string","description":"Phone number for mental health clinic for given facility.","nullable":true,"example":"202-555-1212"},"enrollment_coordinator":{"type":"string","description":"Phone number for enrollment coordinator for given facility.","nullable":true,"example":"202-555-1212"},"health_connect":{"type":"string","description":"Phone number for VA Health Connect.","nullable":true,"example":"312-122-4516"}},"description":"Collection of all telephone contact numbers for given facility. ","nullable":true,"example":"1-800-827-1000"},"Properties":{"required":["facility_type","id","operating_status"],"type":"object","properties":{"id":{"type":"string","description":"Identifier representing the Facility.","example":"vha_688"},"name":{"type":"string","description":"Name associated with given facility.","example":"Washington VA Medical Center"},"facility_type":{"type":"string","description":"One of facility top-level type categories (e.g.) health, benefits, cemetery and vet center.","example":"va_health_facility","enum":["va_benefits_facility","va_cemetery","va_health_facility","vet_center"]},"classification":{"type":"string","description":"Subtype of facility which can further be used to describe facility.","nullable":true,"example":"VA Medical Center (VAMC)"},"website":{"type":"string","description":"Web address of facility.","nullable":true,"example":"http://www.washingtondc.va.gov"},"time_zone":{"type":"string","description":"Facility time zone","format":"String","example":"America/New_York"},"address":{"$ref":"#/components/schemas/Addresses"},"phone":{"$ref":"#/components/schemas/Phone"},"hours":{"$ref":"#/components/schemas/Hours"},"operational_hours_special_instructions":{"type":"string","description":"Additional information about facility operating hours.","nullable":true,"example":"[\"More hours are available for some services.\",\"If you need to talk to someone, call the Vet Center at 1-877-927-8387.\",\"Vet Center hours are dependent upon outreach assignments.\"]"},"services":{"$ref":"#/components/schemas/Services"},"satisfaction":{"$ref":"#/components/schemas/Satisfaction"},"wait_times":{"$ref":"#/components/schemas/WaitTimes"},"mobile":{"type":"boolean","nullable":true,"example":false},"active_status":{"type":"string","description":"This field is deprecated and replaced with \"operating_status\".","nullable":true,"enum":["A","T"]},"operating_status":{"$ref":"#/components/schemas/OperatingStatus"},"visn":{"type":"string","nullable":true,"example":"20"},"detailed_services":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/DetailedService"}}},"description":"Details describing a facility.","nullable":true},"Satisfaction":{"type":"object","properties":{"health":{"$ref":"#/components/schemas/PatientSatisfaction"},"effective_date":{"type":"string","format":"date","nullable":true,"example":"2018-01-01"}},"description":"Scores that indicate patient satisfaction at given facility per service.","nullable":true},"Services":{"type":"object","properties":{"other":{"type":"array","description":"List of other services not included in one of the other service categories.","nullable":true,"items":{"type":"string","enum":["OnlineScheduling"]}},"health":{"type":"array","description":"List of health services for given facility.","nullable":true,"items":{"type":"string","enum":["Audiology","Cardiology","CaregiverSupport","Covid19Vaccine","DentalServices","Dermatology","EmergencyCare","Gastroenterology","Gynecology","MentalHealthCare","Ophthalmology","Optometry","Orthopedics","Nutrition","Podiatry","PrimaryCare","SpecialtyCare","UrgentCare","Urology","WomensHealth"]}},"benefits":{"type":"array","description":"List of benefits services for given facility.","nullable":true,"items":{"type":"string","enum":["ApplyingForBenefits","BurialClaimAssistance","DisabilityClaimAssistance","eBenefitsRegistrationAssistance","EducationAndCareerCounseling","EducationClaimAssistance","FamilyMemberClaimAssistance","HomelessAssistance","InsuranceClaimAssistanceAndFinancialCounseling","IntegratedDisabilityEvaluationSystemAssistance","Pensions","PreDischargeClaimAssistance","TransitionAssistance","UpdatingDirectDepositInformation","VAHomeLoanAssistance","VocationalRehabilitationAndEmploymentAssistance"]}},"last_updated":{"type":"string","description":"Date of the most recent change in offered services.","format":"date","nullable":true,"example":"2018-01-01"}},"description":"All services offered by a VA health or benefits facility grouped by service type.","nullable":true},"SupplementalStatus":{"required":["id","label"],"type":"object","properties":{"id":{"type":"string","description":"Unique id for supplemental status.","example":"COVID_LOW"},"label":{"type":"string","description":"Descriptive label for supplemental status.","example":"COVID-19 health protection guidelines: Levels low"}},"description":"Supplemental status for VA facility.","nullable":true},"WaitTimes":{"type":"object","properties":{"health":{"type":"array","description":"List of expected patient wait times for given health service.","nullable":true,"items":{"$ref":"#/components/schemas/PatientWaitTime"}},"effective_date":{"type":"string","description":"The effective date of when the access to care survey was carried out.","format":"date","nullable":true,"example":"2018-01-01"}},"description":"Collection of wait times reported for various services based on access to care survey.","nullable":true,"example":10},"GenericError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","example":"Detailed Error Message"}},"description":"A general error json response for things like Authorization Errors or Bad Requests (ex. invalid parameter values)."},"ApiError":{"required":["errors"],"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorMessage"}}},"description":"API invocation or processing error"},"ErrorMessage":{"type":"object","properties":{"title":{"type":"string","example":"Error title"},"detail":{"type":"string","example":"Detailed error message"},"code":{"type":"string","example":"103"},"status":{"type":"string","example":"400"}}},"Distance":{"required":["distance","id"],"type":"object","properties":{"id":{"type":"string","description":"Identifier of facility.","example":"vc_0101V"},"distance":{"type":"number","description":"Distance to facility in decimal format.","example":54.13}},"description":"Distance to facility in miles using decimal format. Used when querying for facilities proximal to a location. ","example":54.13},"FacilitiesMetadata":{"required":["pagination"],"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"distances":{"type":"array","items":{"$ref":"#/components/schemas/Distance"}}},"description":"Metadata representation for data in response. This metadata includes paginated items that allow user to see the current page, objects perPage, total pages and total entries."},"FacilitiesResponse":{"required":["links","meta"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Facility"}},"links":{"$ref":"#/components/schemas/PageLinks"},"meta":{"$ref":"#/components/schemas/FacilitiesMetadata"}},"description":"JSON API-compliant response object describing one or more VA facilities"},"Facility":{"required":["attributes","id","type"],"type":"object","properties":{"id":{"type":"string","description":"Identifier representing facility.","example":"vha_688"},"type":{"type":"string","description":"One of 4 facility top-level type categories (e.g. health, benefits, cemetery and vet center).","example":"va_facilities","enum":["va_facilities"]},"attributes":{"$ref":"#/components/schemas/FacilityAttributes"}},"description":"JSON API representation of a Facility."},"FacilityAttributes":{"required":["facility_type","lat","long","name","operating_status"],"type":"object","properties":{"name":{"type":"string","description":"Name associated with given facility.","example":"Washington VA Medical Center"},"facility_type":{"type":"string","description":"One of facility top-level type categories (e.g.) health, benefits, cemetery and vet center.","example":"va_health_facility","enum":["va_benefits_facility","va_cemetery","va_health_facility","vet_center"]},"classification":{"type":"string","description":"Subtype of facility which can further be used to describe facility.","nullable":true,"example":"VA Medical Center (VAMC)"},"website":{"type":"string","description":"Web address of facility.","nullable":true,"example":"http://www.washingtondc.va.gov"},"lat":{"type":"number","description":"Facility latitude.","format":"float","example":38.9311137},"long":{"type":"number","description":"Facility longitude.","format":"float","example":-77.0109110499999},"time_zone":{"type":"string","description":"Facility time zone.","format":"String","example":"America/New_York"},"address":{"$ref":"#/components/schemas/Addresses"},"phone":{"$ref":"#/components/schemas/Phone"},"hours":{"$ref":"#/components/schemas/Hours"},"operational_hours_special_instructions":{"type":"string","description":"Additional information about a VA health or Vet Center facility's operating hours.","nullable":true,"example":"Normal business hours are Monday through Friday, 8:00 a.m. to 4:30 p.m."},"services":{"$ref":"#/components/schemas/Services"},"satisfaction":{"$ref":"#/components/schemas/Satisfaction"},"wait_times":{"$ref":"#/components/schemas/WaitTimes"},"mobile":{"type":"boolean","nullable":true,"example":false},"active_status":{"type":"string","description":"This field is deprecated and replaced with \"operating_status\".","nullable":true,"enum":["A","T"]},"operating_status":{"$ref":"#/components/schemas/OperatingStatus"},"detailed_services":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/DetailedService"}},"visn":{"type":"string","nullable":true,"example":"20"}},"description":"Details describing a facility.","nullable":true},"PageLinks":{"required":["self"],"type":"object","properties":{"related":{"type":"string","description":"Link to related pages of response.","nullable":true,"example":"https://api.va.gov/services/va_facilities/v0/facilities?id=vha_688"},"self":{"type":"string","description":"Link to current page of response.","nullable":true,"example":"https://api.va.gov/services/va_facilities/v0/facilities?type=health&page=1&per_page=1000"},"first":{"type":"string","description":"Link to first page of response.","nullable":true,"example":"https://api.va.gov/services/va_facilities/v0/facilities?type=health&page=1&per_page=1000"},"prev":{"type":"string","description":"Link to previous page of response.","nullable":true,"example":"https://api.va.gov/services/va_facilities/v0/facilities?type=health&page=1&per_page=1000"},"next":{"type":"string","description":"Link to next page of response.","nullable":true,"example":"https://api.va.gov/services/va_facilities/v0/facilities?type=health&page=2&per_page=1000"},"last":{"type":"string","description":"Link to last page of response.","nullable":true,"example":"https://api.va.gov/services/va_facilities/v0/facilities?type=health&page=4&per_page=1000"}},"description":"Links for first page, next page, previous and last page of response."},"Pagination":{"required":["current_page","per_page","total_entries","total_pages"],"type":"object","properties":{"current_page":{"type":"integer","description":"Current page of response.","format":"int32","example":1},"per_page":{"type":"integer","description":"Number of results per page.","format":"int32","example":20},"total_pages":{"type":"integer","description":"Total number of pages matching this query.","format":"int32","example":250},"total_entries":{"type":"integer","description":"Total number of entries matching this query.","format":"int32","example":2162}},"description":"Pagination data reflecting response that has been seperated into discrete pages."},"FacilityReadResponse":{"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/Facility"}},"description":"Response that contains facility data."},"GeoFacilityReadResponse":{"required":["geometry","properties","type"],"type":"object","properties":{"type":{"type":"string","enum":["Feature"]},"geometry":{"$ref":"#/components/schemas/Geometry"},"properties":{"$ref":"#/components/schemas/Properties"}},"description":"Response that contains GeoFacility data."},"FacilitiesIdsResponse":{"type":"object","properties":{"data":{"type":"array","description":"List of VA facility ids.","items":{"type":"string"}}},"description":"JSON API response for a query for facility ids."},"Meta":{"type":"object","properties":{"band_version":{"type":"string","description":"Version of the drive time band data set used to generate this response.","nullable":true,"example":"APR2021"}},"description":"JSON API-compliant object containing metadata about this response.","nullable":true},"Nearby":{"required":["attributes","id","type"],"type":"object","properties":{"id":{"type":"string","description":"Identifier for facility.","example":"vha_688"},"type":{"type":"string","description":"Type of facility.","example":"va_health_facility","enum":["nearby_facility"]},"attributes":{"$ref":"#/components/schemas/NearbyAttributes"}},"description":"JSON API-compliant object describing a nearby VA facility.","nullable":true},"NearbyAttributes":{"required":["max_time","min_time"],"type":"object","properties":{"min_time":{"type":"integer","description":"Minimum time to reach facility.","format":"int32","example":10},"max_time":{"type":"integer","description":"Maximum time to reach facility.","format":"int32","example":20}},"nullable":true},"NearbyResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Nearby"}},"meta":{"$ref":"#/components/schemas/Meta"}},"description":"Response which contains minimum and maximum time it takes to reach facility.","nullable":true}},"securitySchemes":{"apikey":{"in":"header","name":"apikey","type":"apiKey"}}},"servers":[{"url":"https://sandbox-api.va.gov/services/va_facilities/{version}","description":"Sandbox","variables":{"version":{"default":"v0"}}},{"url":"https://api.va.gov/services/va_facilities/{version}","description":"Production","variables":{"version":{"default":"v0"}}}],"security":[{"apikey":[]}]}