The Veteran Confirmation API allows you to confirm Veteran status for a given person. This can be useful for offering Veterans discounts or other benefits.
The API will only return “Confirmed” or “Not Confirmed”.
Get started by filling out the form on the Apply for VA Lighthouse Developer Access page.
After submitting a request, you will receive your credentials for using the API in the Development environment, which allows you to try it out with mock data before moving to the Production environment.
In the endpoint documentation below, we’ve provided a curl command builder for trying out the API before implementation with your app. Use Test User attributes to populate the request body.
The base URI for the Veteran Confirmation API in the Sandbox environment is:
In this environment, use attributes from the list of Test Users. Only Test Users can return a
After building your app, we ask that you give us a demo before we set you up with production credentials. Please see the Path to Production page for more details.
This API requires an API key in combination with identifiable information for the person being confirmed listed below. API requests are authorized through a symmetric API token provided in an HTTP header with name
apikey. Including more information has a better chance of making a match and returning a Confirmed status.
APIs accessed via the Sandbox environment are using the same underlying logic as VA’s production APIs; only the underlying data store is different.
The Master Veteran Index confirms a user’s identity. In Production, several factors are considered to confirm identity. These include: a user’s first name, last name, date of birth and Social Security number. The MVI is mocked in the Sandbox environment. In this environment, the only factor used to confirm identity is the Social Security number.
We implemented basic rate limiting of 60 requests per minute. If you exceed this quota, your request will return a 429 status code. You may petition for increased rate limits by emailing and requests will be decided on a case by case basis.
Use this page to mock Veteran Confirmation in your testing and development.
Run our mock API sample using the open source WireMock library, or in the free edition of WireMock Cloud. You'll have a working API server simulating the behavior of Veteran Confirmation, which will allow you to keep building and testing even if the actual API you isn't currently available.