Veterans Affairs website screenshot

Veterans Affairs

The US Department of Veterans Affairs (VA) Lighthouse API platform provides a portfolio of public-facing REST APIs enabling third-party developers and partners to access veteran benefits data, health records (FHIR), appeals and decision review status, facilities information, forms, and service history verification. APIs support OAuth 2.0 with OpenID Connect and API key authentication and are available with sandbox and production environments.

Veterans Affairs publishes 15 APIs on the APIs.io network, including Appealable Issues API, Appeals Status API, Contestable Issues API, and 12 more. Tagged areas include Veterans, Government, Health, Benefits, and FHIR.

The Veterans Affairs catalog on APIs.io includes 1 JSON-LD context.

Veterans Affairs’ developer surface includes authentication, documentation, engineering blog, pricing, and 12 more developer resources.

42.0/100 developing ▼ -5.3 Agent 41/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
25 APIs
VeteransGovernmentHealthBenefitsFHIRAppealsFederal

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 42.0/100 · developing
Contract Quality 15.4 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 5.5 / 13
Governance 0.0 / 12
Discoverability 7.4 / 10
Agent readiness — 41/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/va: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 25

Individual APIs this provider publishes, each with its own machine-readable definition.

Patient Health API (FHIR)

Allows Veterans and authorized third parties to access patient health data using the HL7 FHIR R4 standard, including records, medications, conditions, immunizations, and appoint...

Health Care Costs and Coverage API (FHIR)

Provides access to health care expense data for VA patients including medical charges, services received, and payments for health-related expenses using the FHIR standard.

Appeals Status API

Enables authorized parties to request the status of a Veteran's benefits claim appeal, including the current step in the process, estimated decision dates, and hearing information.

Decision Reviews API

Allows accredited representatives and Veterans to interact with VA decision reviews (benefit appeals), including submitting Supplemental Claims, Higher-Level Reviews, and Board ...

VA Facilities API

Provides location information and services data for VA facilities including VA Medical Centers, community-based outpatient clinics, Vet Centers, and benefits offices across the ...

VA Forms API

Provides information about VA forms including metadata, current versions, and downloadable URLs for official VA forms used in benefits and healthcare applications.

Veteran Verification API

Allows authorized third parties to verify a Veteran's service history, Veteran status, discharge information, and disability rating using OAuth 2.0 authorization from the Veteran.

Direct Deposit Management API

Enables accredited VSO representatives to view and update direct deposit information for Veterans receiving VA disability compensation and pension payments.

VA Letter Generator API

Allows Veterans and authorized third parties to generate official VA letters confirming veteran status, service history, benefit summary, and other information required for hous...

Benefits Reference Data API

Provides reference data used for VA benefits forms and applications, including lists of service branches, discharge types, disabilities, countries, and other standardized VA dat...

Veterans Affairs Appealable Issues API

The Appealable Issues API from Veterans Affairs — 1 operation(s) for appealable issues.

Veterans Affairs Appeals Status API

The Appeals Status API from Veterans Affairs — 1 operation(s) for appeals status.

Veterans Affairs Contestable Issues API

The Contestable Issues API from Veterans Affairs — 1 operation(s) for contestable issues.

Veterans Affairs Higher-Level Reviews API

The Higher-Level Reviews API from Veterans Affairs — 10 operation(s) for higher-level reviews.

Veterans Affairs Labs And Tests API

The Labs And Tests API from Veterans Affairs — 1 operation(s) for labs and tests.

Veterans Affairs Legacy Appeals API

The Legacy Appeals API from Veterans Affairs — 2 operation(s) for legacy appeals.

Veterans Affairs Medical Records API

The Medical Records API from Veterans Affairs — 30 operation(s) for medical records.

Veterans Affairs Messaging API

The Messaging API from Veterans Affairs — 20 operation(s) for messaging.

Veterans Affairs Notice of Disagreements API

The Notice of Disagreements API from Veterans Affairs — 15 operation(s) for notice of disagreements.

Veterans Affairs Other Accredited Representatives API

The Other Accredited Representatives API from Veterans Affairs — 1 operation(s) for other accredited representatives.

Veterans Affairs Prescriptions API

The Prescriptions API from Veterans Affairs — 8 operation(s) for prescriptions.

Veterans Affairs Supplemental Claims API

The Supplemental Claims API from Veterans Affairs — 15 operation(s) for supplemental claims.

Veterans Affairs Tooltips API

The Tooltips API from Veterans Affairs — 2 operation(s) for tooltips.

Veterans Affairs Unique User Metrics API

The Unique User Metrics API from Veterans Affairs — 1 operation(s) for unique user metrics.

Veterans Affairs VSO Accredited Representatives API

The VSO Accredited Representatives API from Veterans Affairs — 1 operation(s) for vso accredited representatives.

Scroll for all 25

Pricing Plans 1

Published pricing tiers and plan structures.

Va Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Va Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Va Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Va Context

0 classes · 0 properties

JSON-LD

Examples 5

Example request and response payloads for these APIs.

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Va Authentication

apiKey/http/oauth2 · 5 schemes

SECURITY

Va Domain Security

TLSv1.2 · HSTS · DNSSEC · DMARC

SECURITY

Va Vulnerability Disclosure

Bugcrowd · security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Va Scopes

35 scopes · authorizationCode/clientCredentials

35 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Va Agentic Access

114 operations · 39 acting

114 operations · 39 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: va
name: Veterans Affairs
description: The US Department of Veterans Affairs (VA) Lighthouse API platform provides a portfolio of public-facing REST
  APIs enabling third-party developers and partners to access veteran benefits data, health records (FHIR), appeals and decision
  review status, facilities information, forms, and service history verification. APIs support OAuth 2.0 with OpenID Connect
  and API key authentication and are available with sandbox and production environments.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/va.png
url: https://raw.githubusercontent.com/api-evangelist/va/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
- Veterans
- Government
- Health
- Benefits
- FHIR
- Appeals
- Federal
apis:
- name: Patient Health API (FHIR)
  description: Allows Veterans and authorized third parties to access patient health data using the HL7 FHIR R4 standard,
    including records, medications, conditions, immunizations, and appointments from VA facilities.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/patient-health
  baseURL: https://api.va.gov/services/fhir/v0/r4
  tags:
  - Health
  - FHIR
  - Medical Records
  - R4
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/patient-health/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: Health Care Costs and Coverage API (FHIR)
  description: Provides access to health care expense data for VA patients including medical charges, services received, and
    payments for health-related expenses using the FHIR standard.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/health-care-costs-coverage
  baseURL: https://api.va.gov/services/fhir/v0/r4
  tags:
  - Health
  - FHIR
  - Costs
  - Coverage
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/health-care-costs-coverage
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: Appeals Status API
  description: Enables authorized parties to request the status of a Veteran's benefits claim appeal, including the current
    step in the process, estimated decision dates, and hearing information.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/appeals-status
  baseURL: https://api.va.gov/services/appeals/v1
  tags:
  - Appeals
  - Benefits
  - Claims
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/appeals-status/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: Decision Reviews API
  description: Allows accredited representatives and Veterans to interact with VA decision reviews (benefit appeals), including
    submitting Supplemental Claims, Higher-Level Reviews, and Board Appeals.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/decision-reviews
  baseURL: https://api.va.gov/services/appeals/v2
  tags:
  - Decision Reviews
  - Appeals
  - Benefits
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/decision-reviews/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: VA Facilities API
  description: Provides location information and services data for VA facilities including VA Medical Centers, community-based
    outpatient clinics, Vet Centers, and benefits offices across the United States.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/va-facilities
  baseURL: https://api.va.gov/services/va_facilities/v1
  tags:
  - Facilities
  - Locations
  - Healthcare
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/va-facilities/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: VA Forms API
  description: Provides information about VA forms including metadata, current versions, and downloadable URLs for official
    VA forms used in benefits and healthcare applications.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/va-forms
  baseURL: https://api.va.gov/services/va_forms/v0
  tags:
  - Forms
  - Documents
  - Benefits
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/va-forms/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: Veteran Verification API
  description: Allows authorized third parties to verify a Veteran's service history, Veteran status, discharge information,
    and disability rating using OAuth 2.0 authorization from the Veteran.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/veteran-service-history-and-eligibility
  baseURL: https://api.va.gov/services/veteran_verification/v2
  tags:
  - Verification
  - Service History
  - Disability
  - Status
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/veteran-service-history-and-eligibility/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: Direct Deposit Management API
  description: Enables accredited VSO representatives to view and update direct deposit information for Veterans receiving
    VA disability compensation and pension payments.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/direct-deposit-management
  baseURL: https://api.va.gov/services/direct-deposit-management/v1
  tags:
  - Direct Deposit
  - Benefits
  - Compensation
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/direct-deposit-management/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: VA Letter Generator API
  description: Allows Veterans and authorized third parties to generate official VA letters confirming veteran status, service
    history, benefit summary, and other information required for housing, employment, and benefits purposes.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/va-letter-generator
  baseURL: https://api.va.gov/services/letter-generator/v0
  tags:
  - Letters
  - Benefits
  - Verification
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/va-letter-generator/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- name: Benefits Reference Data API
  description: Provides reference data used for VA benefits forms and applications, including lists of service branches, discharge
    types, disabilities, countries, and other standardized VA data sets.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.va.gov/explore/api/benefits-reference-data
  baseURL: https://api.va.gov/services/benefits-reference-data/v1
  tags:
  - Benefits
  - Reference Data
  - Forms
  properties:
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-reference-data/docs
  contact:
  - FN: VA API Platform Support
    email: api@va.gov
- aid: va:va-appealable-issues-api
  name: Veterans Affairs Appealable Issues API
  description: The Appealable Issues API from Veterans Affairs — 1 operation(s) for appealable issues.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Appealable Issues
  properties:
  - type: OpenAPI
    url: openapi/va-appealable-issues-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-appeals-status-api
  name: Veterans Affairs Appeals Status API
  description: The Appeals Status API from Veterans Affairs — 1 operation(s) for appeals status.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Appeals Status
  properties:
  - type: OpenAPI
    url: openapi/va-appeals-status-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-contestable-issues-api
  name: Veterans Affairs Contestable Issues API
  description: The Contestable Issues API from Veterans Affairs — 1 operation(s) for contestable issues.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Contestable Issues
  properties:
  - type: OpenAPI
    url: openapi/va-contestable-issues-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-higher-level-reviews-api
  name: Veterans Affairs Higher-Level Reviews API
  description: The Higher-Level Reviews API from Veterans Affairs — 10 operation(s) for higher-level reviews.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Higher-Level Reviews
  properties:
  - type: OpenAPI
    url: openapi/va-higher-level-reviews-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-labs-and-tests-api
  name: Veterans Affairs Labs And Tests API
  description: The Labs And Tests API from Veterans Affairs — 1 operation(s) for labs and tests.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Labs And Tests
  properties:
  - type: OpenAPI
    url: openapi/va-labs-and-tests-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-legacy-appeals-api
  name: Veterans Affairs Legacy Appeals API
  description: The Legacy Appeals API from Veterans Affairs — 2 operation(s) for legacy appeals.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Legacy Appeals
  properties:
  - type: OpenAPI
    url: openapi/va-legacy-appeals-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-medical-records-api
  name: Veterans Affairs Medical Records API
  description: The Medical Records API from Veterans Affairs — 30 operation(s) for medical records.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Medical Records
  properties:
  - type: OpenAPI
    url: openapi/va-medical-records-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-messaging-api
  name: Veterans Affairs Messaging API
  description: The Messaging API from Veterans Affairs — 20 operation(s) for messaging.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Messaging
  properties:
  - type: OpenAPI
    url: openapi/va-messaging-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-notice-of-disagreements-api
  name: Veterans Affairs Notice of Disagreements API
  description: The Notice of Disagreements API from Veterans Affairs — 15 operation(s) for notice of disagreements.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Notice of Disagreements
  properties:
  - type: OpenAPI
    url: openapi/va-notice-of-disagreements-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-other-accredited-representatives-api
  name: Veterans Affairs Other Accredited Representatives API
  description: The Other Accredited Representatives API from Veterans Affairs — 1 operation(s) for other accredited representatives.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Other Accredited Representatives
  properties:
  - type: OpenAPI
    url: openapi/va-other-accredited-representatives-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-prescriptions-api
  name: Veterans Affairs Prescriptions API
  description: The Prescriptions API from Veterans Affairs — 8 operation(s) for prescriptions.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Prescriptions
  properties:
  - type: OpenAPI
    url: openapi/va-prescriptions-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-supplemental-claims-api
  name: Veterans Affairs Supplemental Claims API
  description: The Supplemental Claims API from Veterans Affairs — 15 operation(s) for supplemental claims.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Supplemental Claims
  properties:
  - type: OpenAPI
    url: openapi/va-supplemental-claims-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-tooltips-api
  name: Veterans Affairs Tooltips API
  description: The Tooltips API from Veterans Affairs — 2 operation(s) for tooltips.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Tooltips
  properties:
  - type: OpenAPI
    url: openapi/va-tooltips-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-unique-user-metrics-api
  name: Veterans Affairs Unique User Metrics API
  description: The Unique User Metrics API from Veterans Affairs — 1 operation(s) for unique user metrics.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - Unique User Metrics
  properties:
  - type: OpenAPI
    url: openapi/va-unique-user-metrics-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
- aid: va:va-vso-accredited-representatives-api
  name: Veterans Affairs VSO Accredited Representatives API
  description: The VSO Accredited Representatives API from Veterans Affairs — 1 operation(s) for vso accredited representatives.
  humanURL: https://developer.va.gov/explore/api/benefits-intake
  baseURL: https://api.va.gov/services/benefits-intake/v2
  tags:
  - VSO Accredited Representatives
  properties:
  - type: OpenAPI
    url: openapi/va-vso-accredited-representatives-api-openapi.yml
  - type: Documentation
    url: https://developer.va.gov/explore/api/benefits-intake/docs
common:
- type: AgenticAccess
  url: agentic-access/va-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/va-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/va-domain-security.yml
- type: Authentication
  url: authentication/va-authentication.yml
- type: OAuthScopes
  url: scopes/va-scopes.yml
- type: Website
  url: https://www.va.gov
- type: Documentation
  url: https://developer.va.gov
- type: GitHubOrg
  url: https://github.com/department-of-veterans-affairs
- type: LinkedIn
  url: https://www.linkedin.com/company/department-of-veterans-affairs
- type: Blog
  url: https://news.va.gov
- type: Pricing
  url: https://developer.va.gov/onboarding/working-with-lighthouse-apis
- type: StatusPage
  url: https://valighthouse.statuspage.io
- type: X
  url: https://x.com/deptvetaffairs
- type: Plans
  url: plans/va-plans-pricing.yml
- type: RateLimits
  url: rate-limits/va-rate-limits.yml
- type: FinOps
  url: finops/va-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com