Veterans Affairs Facilities (Independent Publisher) (Preview)

The United States Department of Veterans Affairs (VA) Facilities service offers comprehensive details on VA health, benefits, cemeteries, and Vet Centers, including location, contact information, and services available. Data is sourced from both real-time and historical records, ensuring users have access to the latest facility updates. Authentication is managed via symmetric tokens, and the service provides a robust framework for accessing VA facility information efficiently.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Richard Wilson
URL	https://www.richardawilson.com/
Email	richard.a.wilson@microsoft.com

Connector Metadata
Publisher	Richard Wilson
Website	https://developer.va.gov/explore/api/va-facilities
Privacy policy	https://department.va.gov/privacy/
Categories	Human Resources

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
VA API Key	securestring	The VA API Key for this api	True
Environment	string	The VA API environment to use (Production or Sandbox)	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Get a facility by ID	Returns detailed information about a specific facility, identified by its unique ID.
Get details for a specific service at a facility	Retrieves detailed information about a specific service offered by a facility, identified by both facility ID and service ID.
List all facility IDs	Provides a bulk download option for all facility IDs, with the capability to filter by facility type for more targeted results.
List all nearby facilities	Retrieves all facilities within a specified drive time from a given location, with optional filtering by services.
List facilities	Query facilities with a combination of optional search parameters.
List services for a specific facility	Queries services offered by a facility, with optional parameters to refine results. Supports independent or combined use of serviceIds and serviceType for filtering.

Get a facility by ID

Operation ID:

GetFacilityById

Returns detailed information about a specific facility, identified by its unique ID.

Parameters

Name	Key	Required	Type	Description
Facility ID	facilityId	True	string	The unique identifier of the facility, following the format <prefix>_<station>, with prefixes like 'vha' (health facility), 'vba' (benefits), 'nca' (cemetery), or 'vc' (vet center).

Returns

Contains detailed data for a single facility.

Facility Read Response

FacilityReadResponse

Get details for a specific service at a facility

Operation ID:

GetFacilityServiceById

Retrieves detailed information about a specific service offered by a facility, identified by both facility ID and service ID.

Parameters

Name	Key	Required	Type	Description
Facility ID	facilityId	True	string	The facility's unique identifier, structured as <prefix>_<station>, where the prefix indicates the type of facility (e.g., 'vha' for health facilities, 'vba' for benefits, etc.).
Service ID	serviceId	True	string	The unique identifier for the specific service within the facility.

Returns

Contains expanded details for a specific service offered by a facility.

Detailed Service Response

DetailedServiceResponse

List all facility IDs

Operation ID:

GetFacilityIds

Provides a bulk download option for all facility IDs, with the capability to filter by facility type for more targeted results.

Parameters

Name	Key	Required	Type	Description
Facility Type	type		string	Filter for searching by facility type, such as health, cemetery, benefits, or vet center.

Returns

Provides a list of unique identifiers for VA facilities.

Facility IDs Response

FacilitiesIdsResponse

List all nearby facilities

Operation ID:

GetNearbyFacilities

Retrieves all facilities within a specified drive time from a given location, with optional filtering by services.

Parameters

Name	Key	Required	Type	Description
Latitude	lat	True	float	Latitude from which drive time is calculated.
Longitude	long	True	float	Longitude from which drive time is calculated.
Drive Time	drive_time		integer	Maximum drive time in minutes from the location to include facilities.
Services Filter	services[]		string	An optional comma separated list of service to filter by.
Page Number	page		integer	The page number of results to return.
Results Per Page	per_page		integer	The number of results to return per page.

Returns

Response object containing minimum and maximum times to reach nearby VA facilities.

Nearby Facilities Response

NearbyResponse

List facilities

Operation ID:

GetFacilities

Query facilities with a combination of optional search parameters.

Parameters

Name	Key	Required	Type	Description
Facility IDs	facilityIds		string	Comma separated list of facility IDs for the search.
Zip Code	zip		string	Zip code for searching facilities, considering only the first five digits.
State	state		string	State for facility search, typically a two-character code.
Latitude	lat		float	Latitude for facility search in WGS84 coordinates.
Longitude	long		float	Longitude for facility search in WGS84 coordinates.
Radius	radius		float	Radial distance from specified point to filter facility search, in miles.
Bounding Box	bbox[]		string	Bounding box coordinates for facility search within a geographic area.
VISN	visn		number	VISN (Veterans Integrated Service Networks) code for facility search.
Facility Type	type		string	Type of facility location to filter search results.
Services Offered	services[]		string	A comma separated list of services to filter facilities by the services they offer.
Include Mobile Facilities	mobile		boolean	Flag to include or exclude mobile facilities in the search results.
Page Number	page		integer	Page number of results to return in a paginated response.
Results Per Page	per_page		integer	Number of results per page in a paginated response.

Returns

Describes the response object for one or more VA facilities, including data, pagination links, and metadata.

Facilities Response

FacilitiesResponse

List services for a specific facility

Operation ID:

GetFacilityServicesById

Queries services offered by a facility, with optional parameters to refine results. Supports independent or combined use of serviceIds and serviceType for filtering.

Parameters

Name	Key	Required	Type	Description
Facility ID	facilityId	True	string	Unique identifier of the facility, adhering to the format <prefix>_<station>, with prefixes indicating the facility type (e.g., 'vha' for health facility, 'vba' for benefits, etc.).
Service IDs	serviceIds		string	A comma separated list of service IDs to filter the search, usable with or without the serviceType parameter.
Service Type	serviceType		string	Service type to filter the search, usable with or without the serviceIds parameter.

Returns

An object containing a list of detailed services provided by a facility.

Detailed Services Response

DetailedServicesResponse

Definitions

Address

Represents a physical address.

Name	Path	Type	Description
Address Line 1	address1	string	First line of the address, typically including street name and number.
Address Line 2	address2	string	Second line of the address, if applicable, such as a building number or complex name.
Address Line 3	address3	string	Third line of the address, if applicable, such as a unit or suite number.
City	city	string	City component of the address.
State	state	string	State code component of the address.
ZIP Code	zip	string	Postal (ZIP) code component of the address.

Addresses

Holds both mailing and physical addresses for a facility.

Name	Path	Type	Description
mailing	mailing	Address	Represents a physical address.
physical	physical	Address	Represents a physical address.

AppointmentPhoneNumber

Contains phone number information for scheduling an appointment, including extensions and labels.

Name	Path	Type	Description
Extension	extension	string	The extension number for the appointment phone.
Label	label	string	A label describing the appointment phone number (e.g., 'Main phone').
Number	number	string	The primary phone number for appointments.
Type	type	string	The type of contact number, such as 'tel' or 'fax'.

DetailedService

Provides detailed information about a specific service offered by a facility, including appointment information, service availability, and contact details.

Name	Path	Type	Description
Appointment Lead-In	appointmentLeadIn	string	Provides additional appointment information, which may include HTML or string formatting characters.
Appointment Phones	appointmentPhones	array of AppointmentPhoneNumber	A list of phone numbers for scheduling appointments related to this service.
Last Updated	lastUpdated	date-time	The date and time when the detailed service information was most recently updated.
Service Name	name	string	The name of the service.
Service ID	serviceId	string	A unique identifier for the service.
Service Details Path	path	string	The URL to a page with more details about this service within the facility's health care system.
General Service Information	serviceInfo	ServiceInfo	Basic information about a service provided by the facility, including service type and identifier.
Service Locations	serviceLocations	array of DetailedServiceLocation	A list of locations where the service is available.
Patient Wait Time	waitTime	PatientWaitTime	Indicates the expected wait times for new and established patients for specific health care services at VA facilities.

DetailedServiceAddress

Address information for a specific service location, including street, building, and room details.

Name	Path	Type	Description
Address Line 1	addressLine1	string	The primary street address line.
Address Line 2	addressLine2	string	Additional address information, such as building number.
Building Name/Number	buildingNameNumber	string	Name or number of the building for the service location.
City	city	string	The city of the service location.
Country Code	countryCode	string	The country code of the service location.
State	state	string	The state code of the service location.
Wing/Floor/Room Number	wingFloorOrRoomNumber	string	The specific wing, floor, or room number of the service location.
ZIP Code	zipCode	string	The postal code of the service location.

DetailedServiceEmailContact

Email contact information related to a specific facility service, including the email address and label.

Name	Path	Type	Description
Email Address	emailAddress	string	The email address for contacting the facility service.
Email Label	emailLabel	string	A label or name associated with the email address.

DetailedServiceHours

Represents the hours of operation for a service, formatted as descriptive text. Hours may vary by holidays or events.

Name	Path	Type	Description
Friday	friday	string	Hours of operation for Fridays.
Monday	monday	string	Hours of operation for Mondays.
Saturday	saturday	string	Hours of operation for Saturdays.
Sunday	sunday	string	Hours of operation for Sundays.
Thursday	thursday	string	Hours of operation for Thursdays.
Tuesday	tuesday	string	Hours of operation for Tuesdays.
Wednesday	wednesday	string	Hours of operation for Wednesdays.

DetailedServiceLocation

Provides specific details about a location where a service is offered, including hours, contact info, and scheduling options.

Name	Path	Type	Description
Additional Hours Information	additionalHoursInfo	string	Details about service location hours that may vary depending on staff availability.
Email Contacts	emailContacts	array of DetailedServiceEmailContact	A list of email contacts for facility services.
Office Name	officeName	string	The name of the specific office location providing the service.
Online Scheduling Availability	onlineSchedulingAvailable	string	Indicates if online scheduling is available for the service.
Phone Contacts	phones	array of AppointmentPhoneNumber	A list of phone numbers for scheduling appointments or making inquiries.
Referral Requirement	referralRequired	string	Indicates if a referral is required to access the service.
Detailed Service Address	serviceAddress	DetailedServiceAddress	Address information for a specific service location, including street, building, and room details.
Detailed Service Hours	serviceHours	DetailedServiceHours	Represents the hours of operation for a service, formatted as descriptive text. Hours may vary by holidays or events.
Walk-Ins Accepted	walkInsAccepted	string	Indicates if walk-ins are accepted for accessing the service.

DetailedServiceResponse

Contains expanded details for a specific service offered by a facility.

Name	Path	Type	Description
Detailed Service	data	DetailedService	Provides detailed information about a specific service offered by a facility, including appointment information, service availability, and contact details.

DetailedServicesMetadata

Holds metadata about the response for detailed services, including pagination details.

Name	Path	Type	Description
Pagination Data	pagination	Pagination	Details the pagination structure of the response, including the current page, total pages, entries per page, and total number of entries.

DetailedServicesResponse

An object containing a list of detailed services provided by a facility.

Name	Path	Type	Description
Services List	data	array of DetailedService	A list detailing each service provided.
Page Links	links	PageLinks	Provides hyperlinks to the first, last, next, and previous pages of the paginated response, including a link to related information and the current page.
Detailed Services Metadata	meta	DetailedServicesMetadata	Holds metadata about the response for detailed services, including pagination details.

Distance

Represents the distance to a facility in miles, using a decimal format.

Name	Path	Type	Description
Distance in Miles	distance	number	The distance to the facility, represented in decimal format.
Facility ID	id	string	The identifier of the facility.

FacilitiesIdsResponse

Provides a list of unique identifiers for VA facilities.

Name	Path	Type	Description
Facility IDs	data	array of string	An array of VA facility identifiers.

FacilitiesMetadata

Contains metadata for a response, including pagination and distances to facilities.

Name	Path	Type	Description
Distances to Facilities	distances	array of Distance	An array of distances from a given location to each facility listed in the response.
Pagination Data	pagination	Pagination	Details the pagination structure of the response, including the current page, total pages, entries per page, and total number of entries.

FacilitiesResponse

Describes the response object for one or more VA facilities, including data, pagination links, and metadata.

Name	Path	Type	Description
Facilities Data	data	array of Facility	An array of facility objects providing details about each facility.
Page Links	links	PageLinks	Provides hyperlinks to the first, last, next, and previous pages of the paginated response, including a link to related information and the current page.
Facilities Metadata	meta	FacilitiesMetadata	Contains metadata for a response, including pagination and distances to facilities.

Facility

Details a single VA facility's attributes, location, and services.

Name	Path	Type	Description
Facility Attributes	attributes	FacilityAttributes	Comprehensive details describing a facility, including its type, services offered, and location details.
Facility ID	id	string	A unique identifier for the facility.
Facility Type	type	string	Indicates the top-level type of the facility (e.g., VA health facility).

FacilityAttributes

Comprehensive details describing a facility, including its type, services offered, and location details.

Name	Path	Type	Description
address	address	Addresses	Holds both mailing and physical addresses for a facility.
Classification	classification	string	The subtype of the facility, further describing the facility type.
Facility Type	facilityType	string	The category of the facility, such as health, benefits, cemetery, or vet center.
Operating Hours	hours	Hours	Details the standard operating hours for each day of the week. Note that hours may vary due to holidays or events.
Latitude	lat	float	Geographical latitude of the facility.
Longitude	long	float	Geographical longitude of the facility.
Mobile Facility	mobile	boolean	Indicates if the facility is mobile (true) or stationary (false).
Facility Name	name	string	The official name of the facility.
Operating Status	operatingStatus	OperatingStatus	Describes the current operational status of the facility, indicating normal operations, limited services, closures, or special notices.
Special Operating Hours	operationalHoursSpecialInstructions	array of string	Special instructions regarding the operating hours, including exceptions.
Parent Facility	parent	Parent	Reference data for a facility's parent organization, including ID and API link.
Facility Contact Numbers	phone	Phone	A collection of telephone contact numbers for the facility, covering various services and departments.
Patient Satisfaction Scores	satisfaction	Satisfaction	Contains the patient satisfaction scores for services at the facility, including specific health care service areas.
VA Facility Services	services	Services	A comprehensive list of all services provided by the VA facility, categorized by type such as benefits, health, and other services.
Time Zone	timeZone	string	The time zone in which the facility is located.
Veterans Integrated Service Network (VISN)	visn	string	The VISN to which the facility belongs.
Website	website	string	The official website of the facility.

FacilityReadResponse

Contains detailed data for a single facility.

Name	Path	Type	Description
Facility	data	Facility	Details a single VA facility's attributes, location, and services.

Hours

Details the standard operating hours for each day of the week. Note that hours may vary due to holidays or events.

Name	Path	Type	Description
Friday Hours	friday	string	Operating hours for Friday.
Monday Hours	monday	string	Operating hours for Monday.
Saturday Hours	saturday	string	Operating hours for Saturday.
Sunday Hours	sunday	string	Operating hours for Sunday.
Thursday Hours	thursday	string	Operating hours for Thursday.
Tuesday Hours	tuesday	string	Operating hours for Tuesday.
Wednesday Hours	wednesday	string	Operating hours for Wednesday.

Meta

Contains metadata about the response, including the version of data sets used.

Name	Path	Type	Description
Band Version	bandVersion	string	Indicates the version of the drive time band data set.

Nearby

Describes a VA facility located near a specified location, including facility attributes and identifier.

Name	Path	Type	Description
Nearby Facility Time Attributes	attributes	NearbyAttributes	Provides the minimum and maximum time required to reach the nearby facility.
Facility ID	id	string	Unique identifier for the nearby facility.
Facility Type	type	string	Specifies the type of the nearby facility.

NearbyAttributes

Provides the minimum and maximum time required to reach the nearby facility.

Name	Path	Type	Description
Maximum Time	maxTime	integer	The maximum time, in minutes, to reach the facility.
Minimum Time	minTime	integer	The minimum time, in minutes, to reach the facility.

NearbyResponse

Response object containing minimum and maximum times to reach nearby VA facilities.

Name	Path	Type	Description
Nearby Facilities Data	data	array of Nearby	An array of nearby VA facilities.
Response Metadata	meta	Meta	Contains metadata about the response, including the version of data sets used.

OperatingStatus

Describes the current operational status of the facility, indicating normal operations, limited services, closures, or special notices.

Name	Path	Type	Description
Additional Information	additionalInfo	string	Provides further details on the facility's operational status, such as specific visitor notices.
Status Code	code	string	A code representing the facility's overall operational status.
Supplemental Status	supplementalStatus	array of SupplementalStatus	A list of additional statuses providing more detail about the facility's operations.

PageLinks

Provides hyperlinks to the first, last, next, and previous pages of the paginated response, including a link to related information and the current page.

Name	Path	Type	Description
First Page Link	first	string	URL to the first page of the response.
Last Page Link	last	string	URL to the last page of the response.
Next Page Link	next	string	URL to the next page of the response.
Previous Page Link	prev	string	URL to the previous page of the response.
Related Link	related	string	URL to related pages or information for the response.
Current Page Link	self	string	URL to the current page of the response.

Pagination

Details the pagination structure of the response, including the current page, total pages, entries per page, and total number of entries.

Name	Path	Type	Description
Current Page	currentPage	integer	The number of the current page in the response.
Results Per Page	perPage	integer	The number of results displayed per page.
Total Entries	totalEntries	integer	The total number of entries matching the query.
Total Pages	totalPages	integer	The total number of pages resulting from the query.

Parent

Reference data for a facility's parent organization, including ID and API link.

Name	Path	Type	Description
Parent Facility ID	id	string	The identifier of the parent facility.
Parent Facility API Link	link	string	The URL for API requests regarding the parent facility.

PatientSatisfaction

Veteran-reported satisfaction scores for health care services at VA health facilities.

Name	Path	Type	Description
Primary Care Routine	primaryCareRoutine	float	Satisfaction score for routine primary care.
Primary Care Urgent	primaryCareUrgent	float	Satisfaction score for urgent primary care.
Specialty Care Routine	specialtyCareRoutine	float	Satisfaction score for routine specialty care.
Specialty Care Urgent	specialtyCareUrgent	float	Satisfaction score for urgent specialty care.

PatientWaitTime

Indicates the expected wait times for new and established patients for specific health care services at VA facilities.

Name	Path	Type	Description
Effective Date	effectiveDate	string	The date from which these wait times are effective.
Established Patient Wait Time	established	number	Average wait time for established patients seeking non-urgent appointments.
New Patient Wait Time	new	number	Average wait time for new patients seeking non-urgent appointments.

Phone

A collection of telephone contact numbers for the facility, covering various services and departments.

Name	Path	Type	Description
After Hours	afterHours	string	Contact number available outside of normal operating hours.
Enrollment Coordinator	enrollmentCoordinator	string	Direct line to the facility's enrollment coordinator.
Fax	fax	string	Fax number for the facility.
VA Health Connect	healthConnect	string	Contact number for VA Health Connect services.
Main Contact	main	string	Primary phone number for the facility.
Mental Health Clinic	mentalHealthClinic	string	Contact number for the mental health clinic services.
Patient Advocate	patientAdvocate	string	Direct line to the facility's patient advocate.
Pharmacy	pharmacy	string	Contact number for pharmacy services.

Satisfaction

Contains the patient satisfaction scores for services at the facility, including specific health care service areas.

Name	Path	Type	Description
Effective Date	effectiveDate	string	The date when the satisfaction scores were last updated.
Patient Satisfaction	health	PatientSatisfaction	Veteran-reported satisfaction scores for health care services at VA health facilities.

ServiceBenefitsService

Provides information about a specific benefits service offered by the facility.

Name	Path	Type	Description
Service Link	link	string	URL to detailed information about the benefits service.
Service Name	name	string	The name of the benefits service provided.
Service ID	serviceId	string	A unique identifier for the benefits service.

ServiceHealthService

Details a specific health service offered at the facility, including the service name, a unique identifier, and a link to more information.

Name	Path	Type	Description
Service Link	link	string	A fully qualified link to more information about the health service.
Service Name	name	string	The name of the health service provided by the facility.
Service ID	serviceId	string	A unique identifier for the health service, which can be used to reference the service programmatically.

ServiceInfo

Basic information about a service provided by the facility, including service type and identifier.

Name	Path	Type	Description
Service Name	name	string	Name of the service provided.
Service ID	serviceId	string	Unique identifier for the service.
Service Type	serviceType	string	Category of the service provided (e.g., health, benefits).

ServiceOtherService

Provides information about other types of services offered by the facility that do not fall under the standard health or benefits categories.

Name	Path	Type	Description
Service Link	link	string	A URL linking to detailed information about the service.
Service Name	name	string	The name of the service provided.
Service ID	serviceId	string	A unique identifier for the service.

Services

A comprehensive list of all services provided by the VA facility, categorized by type such as benefits, health, and other services.

Name	Path	Type	Description
Benefits Services	benefits	array of ServiceBenefitsService	A collection of services related to benefits offered by the facility.
Health Services	health	array of ServiceHealthService	A collection of health-related services provided by the facility.
Last Updated	lastUpdated	string	The date when the services information was most recently updated.
Services Link	link	string	A base URL for accessing detailed information about services at the facility.
Other Services	other	array of ServiceOtherService	A list of other services offered by the facility that do not fall under health or benefits.

SupplementalStatus

Additional status information for the VA facility, providing more specific details beyond the basic operational status.

Name	Path	Type	Description
Status ID	id	string	A unique identifier for the supplemental status.
Status Label	label	string	A descriptive label for the supplemental status, explaining its meaning in human-readable terms.