다음을 통해 공유


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

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

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

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

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

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

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.

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.