How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

VA Lighthouse facilities API

VA Facilities API

VA Lighthouse facilities API is one of 35 APIs that VA Lighthouse publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Facilities. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a changelog, and authentication docs.

This API exposes 8 operations across 8 paths, and defines 64 schemas. It is described by OpenAPI 3.0.1, at version 3.

Requests are made against 2 base URLs: https://sandbox-api.va.gov/services/address-validation/{version}, https://api.va.gov/services/address-validation/{version}.

8 operations 8 paths 64 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
3
Base URL
https://api.va.gov/services/va_facilities/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

VA Lighthouse facilities API declares 1 security scheme for authenticating requests. An API key is passed in the header as apikey (apikey). By default, every request must be authenticated.

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

facilities 8

VA Facilities API

GET
/facilities/all
Bulk download information for all facilities
GET:/facilities/all 1 param → 200401403406413429
GET
/facilities
Query facilities by location or IDs, with optional filters
GET:/facilities 13 params → 200401403406413429
GET
/facilities/{id}
Retrieve a specific facility by ID
GET:/facilities/{id} 1 param → 200400401403404406413429
GET
/ids
Bulk download of all facility IDs
GET:/ids 1 param → 200401403406413429
GET
/nearby
Retrieve all VA health facilities reachable by driving within the specified time period
GET:/nearby 8 params → 200400401403406413429
GET
/facilities/{facilityId}
Retrieve a specific facility by ID
GET:/facilities/{facilityId} 1 param → 200400401403404406413429
GET
/facilities/{facilityId}/services/{serviceId}
Query a specific facility service using a service ID and a facility ID.
GET:/facilities/{facilityId}/services/{serviceId} 2 params → 200400401403404406413429
GET
/facilities/{facilityId}/services
Retrieve all services for a given facility
GET:/facilities/{facilityId}/services 3 params → 200400401403404406413429

Schemas 64

The contract defines 64 schemas that model the data the API accepts and returns. The most detailed are FacilityAttributes (19 properties), FacilityAttributes_2 (18 properties), Properties (18 properties), DetailedService (11 properties). Each schema is shown below with its type and property counts.

Address
object
Description of an address.
6 properties
OperatingStatus
object
Current status of facility operations. The overall status of the facility, which can be: Normal Hours and Services, Facility Notice, Limited Hours and/or Servi…
3 properties 1 required
Satisfaction
object
Scores that indicate patient satisfaction at given facility per service.
2 properties
Satisfaction_2
object
Scores that indicate patient satisfaction at given facility per service.
2 properties
ServiceHealthService
object
Service info block.
3 properties
DetailedServiceEmailContact_2
object
Email contact information for facility service.
2 properties
GeoFacilitiesResponse
object
GeoJSON API-compliant response object describing one or more VA facilities.
2 properties 1 required
DetailedServiceAddress
object
Service location address.
8 properties
Meta
object
JSON API-compliant object containing metadata about this response.
1 property
ErrorMessage
object
4 properties
DetailedService_2
object
Detailed information of a facility service.
9 properties
Services
object
All services offered by a VA health or benefits facility grouped by service type.
4 properties
DetailedServicesMetadata
object
Object containing metadata about detailed service response
1 property
ApiError
object
API invocation or processing error
1 property 1 required
GenericError
object
A general error json response for things like Authorization Errors or Bad Requests (ex. invalid parameter values).
1 property 1 required
DetailedService
object
Detailed information of a facility service.
11 properties
Phone_2
object
Collection of all telephone contact numbers for given facility.
8 properties
FacilityReadResponse
object
Response that contains facility data.
1 property 1 required
GeoFacility
object
GeoJSON-complaint Feature object describing a VA Facility
3 properties 3 required
Pagination_2
object
Pagination data reflecting response that has been seperated into discrete pages.
4 properties
PatientWaitTime_2
object
Expected wait times for new and established patients for a given health care service at VA health facilities.
3 properties
Hours
object
Standard hours of operation. Currently formatted as descriptive text suitable for display, with no guarantee of a standard parseable format. Hours of operation…
7 properties
Pagination
object
Pagination data reflecting response that has been seperated into discrete pages.
4 properties 4 required
Services_2
object
All services offered by a VA facility grouped by service type.
5 properties
Facility
object
JSON API representation of a Facility.
3 properties 3 required
GeoFacilityReadResponse
object
Response that contains GeoFacility data.
3 properties 3 required
Facility_2
object
Representation of a Facility.
3 properties
HealthCareSystem
object
Health Care System of the facility
1 property
DetailedServiceLocation_2
object
Details for a location offering a service.
9 properties
DetailedServiceLocation
object
Details for a location offering a service.
9 properties
NearbyAttributes
object
2 properties 2 required
FacilityAttributes_2
object
Details describing a facility.
18 properties 1 required
ServiceOtherService
object
Service info block.
3 properties
WaitTimes
object
Collection of wait times reported for various services based on access to care survey.
2 properties
PageLinks
object
Links for first page, next page, previous and last page of response.
6 properties 1 required
AppointmentPhoneNumber
object
Phone number information for scheduling an appointment.
4 properties
PageLinks_2
object
Links for first page, next page, previous and last page of response.
6 properties
FacilityAttributes
object
Details describing a facility.
19 properties 5 required
Addresses
object
Collection of addresses associated with a facility.
2 properties
DetailedServiceHours
object
Standard hours of operation. Currently formatted as descriptive text suitable for display, with no guarantee of a standard parseable format. Hours of operation…
7 properties
NearbyResponse
object
Response which contains minimum and maximum time it takes to reach facility.
2 properties
DetailedServiceEmailContact
object
Email contact information for facility service.
2 properties
DetailedServiceAddress_2
object
Service location address.
8 properties
Properties
object
Details describing a facility.
18 properties 3 required
DetailedServiceResponse
object
Expanded details for a service.
1 property
OperatingStatus_2
object
Current status of facility operations. The overall status of the facility, which can be: Normal Hours and Services, Facility Notice, Limited Hours and/or Servi…
3 properties 1 required
Nearby
object
JSON API-compliant object describing a nearby VA facility.
3 properties 3 required
FacilitiesMetadata
object
Metadata representation for data in response. This metadata includes paginated items that allow user to see the current page, objects perPage, total pages and…
2 properties 1 required
Distance
object
Distance to facility in miles using decimal format. Used when querying for facilities proximal to a location.
2 properties 2 required
FacilitiesIdsResponse
object
JSON API response for a query for facility ids.
1 property
ApiError_2
object
API invocation or processing error
1 property
PatientSatisfaction
object
Veteran-reported satisfaction score for health care services at VA health facilities.
4 properties
Parent
object
Reference to facility's parent
2 properties
DetailedServiceHours_2
object
Standard hours of operation. Currently formatted as descriptive text suitable for display, with no guarantee of a standard parseable format. Hours of operation…
7 properties
Phone
object
Collection of all telephone contact numbers for given facility.
8 properties
ServiceInfo
object
Service information.
3 properties
ServiceBenefitsService
object
Service info block.
3 properties
SupplementalStatus
object
Supplemental status for VA facility.
2 properties 2 required
PatientSatisfaction_2
object
Veteran-reported satisfaction score for health care services at VA health facilities.
4 properties
Geometry
object
Geometric data giving the physical location of a VA Facility.
2 properties 1 required
DetailedServicesResponse
object
An object containing a list of services.
3 properties
PatientWaitTime
object
Expected wait times for new and established patients for a given health care service at VA health facilities.
3 properties 1 required
FacilitiesResponse
object
JSON API-compliant response object describing one or more VA facilities
3 properties 2 required
FacilityReadResponse_2
object
An object containing facility data.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

va-gov-facilities-api-openapi.yml Raw ↑

Other APIs VA Lighthouse publishes across the network.

Decision Reviews API
Education Benefits API
Loan Guaranty API
Guaranty Remittance API
Health Care Costs Coverage API
VA Lighthouse 5103 Waiver API
VA Lighthouse ACA Coverage API
VA Lighthouse AddressValidation-v3 API
VA Lighthouse Appealable Issues API
VA Lighthouse Appeals Status API
VA Lighthouse Claims API
VA Lighthouse DirectDeposit API
Where this information came from

This is an independent, third-party profile of VA Lighthouse facilities API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.