canonical: https://jentic.com/apis/va.gov/benefits # Va Gov Benefits Intake The VA Benefits Intake API lets authorized third-party systems - such as Veteran Service Organizations, agencies, and Veterans - digitally submit supporting documents for VA benefits claims directly into the Veterans Benefits Administration claims-intake process. It covers compensation, pension and survivors benefits, education, fiduciary, insurance, Veteran Readiness & Employment, and Board of Veterans Appeals claim types. The API issues a secure upload location, accepts the document payload, validates PDFs, and reports submission status, giving submitters a tracked, auditable path into the VBA pipeline. It exposes 6 operations secured with an API key. ## For AI agents Request a secure upload location, submit benefits-claim documents to the VA, validate PDFs before sending, and track submission status. Covers 6 operations secured with an API key. ## Capabilities - Request a secure, time-limited upload location for a document submission - Submit benefits-claim documents directly into the VBA intake pipeline - Validate a PDF document against intake requirements before submitting - Track the processing status of a specific document submission - Download a previously submitted document for verification - Pull a report covering the status of multiple submissions ## Use cases ### Veteran Service Organization Claim Submission Veteran Service Organizations submit supporting documents for a Veteran's benefits claim directly into the VBA intake process. The API issues a secure upload location, accepts the document payload, and returns a tracking identifier so the VSO has an auditable record of the submission. This replaces fax and mail with a digital, status-tracked path for compensation, pension, education, and other claim types. Example prompt: Call POST /uploads to request a secure upload location, then PUT the claim PDF to that location and capture the submission id ### Pre-Submission PDF Validation Before sending a document into the intake pipeline, submitters validate it against VA requirements to catch formatting problems early. The validate-document operation checks the PDF and returns errors so an agent can fix or re-request the file rather than have the submission rejected downstream, reducing claim-processing delays. Example prompt: Call POST /uploads/validate_document with the candidate PDF and report any validation errors before submitting ### Submission Status Tracking and Reporting After submitting, organizations track each document's processing status and pull batch reports to monitor a queue of claims. The API exposes per-submission status and a multi-submission report endpoint, so an agent can surface which documents are received, processing, or errored without contacting the VBA directly. Example prompt: Call GET /uploads/{id} for a submission to read its current status, then GET /uploads/report for a batch summary ### AI Agent Integration via Jentic AI agents submit and track VA benefits documents through Jentic without handling the VA API key directly. The agent searches for the upload operation by intent, receives the matching endpoint schema, and executes the request with Jentic-managed authentication. This lets a casework assistant validate, submit, and monitor claim documents as part of a larger workflow without reading the VA developer docs. Example prompt: Search Jentic for 'submit a benefits claim document', load the returned VA schema, and request an upload location for the Veteran's PDF ## Key resources - **Uploads** — Request an upload location, submit a document payload, retrieve and download a submission, and read submission status - **Validation** — Validate a PDF document against intake requirements before submission - **Reports** — Retrieve a status report covering multiple document submissions ## Why Jentic - **Setup:** Wiring the VA Benefits Intake API by hand means passing the apikey header, choosing between the sandbox and production va.gov hosts, and coding the document upload flow for sensitive Veteran claim data yourself. Through Jentic you install once, import Benefits Intake from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Benefits Intake sends its work through operations rather than a resource id in the path, so limit the agent to the operations it needs, such as submitting a claim document and checking its status. You choose that allowed set, so nothing outside it runs. - **Credential handling:** Your VA-issued API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'submit a benefits claim document', and Jentic returns the matching Benefits Intake operation with its input schema so the agent calls the right endpoint without browsing the VA reference docs. ## Related APIs - **VA Forms** — Look up VA form metadata and download blank forms to accompany an intake submission - **VA Confirmation** — Confirm Veteran status or eligibility alongside a benefits submission ## FAQ ### What authentication does the VA Benefits Intake API use? It uses an API key issued by the VA developer program, passed in the apikey header. Through Jentic, the key is stored encrypted in your Jentic One instance and injected at request time, so it never enters an agent's context. ### What claim types does the Benefits Intake API support? It handles documents for compensation, pension and survivors benefits, education, fiduciary, insurance, Veteran Readiness & Employment, and Board of Veterans Appeals claims. ### Can I check whether a submitted document was accepted? Yes. Call GET /uploads/{id} for a single submission's status or GET /uploads/report for a batch report covering multiple submissions. ### Does the VA Benefits Intake API support AI agent integration? Yes, through Jentic. An agent searches for an operation such as 'submit a benefits claim document', loads the returned schema, and executes the call with Jentic-managed credentials. Install with pip install jentic and use the search, load, execute flow. ### Is there a sandbox environment? Yes. The base URL points to https://sandbox-api.va.gov for testing; production access requires VA approval through the VA developer program. ### Can I validate a document before submitting it? Yes. POST /uploads/validate_document checks a PDF against intake requirements and returns errors so you can correct the file before sending it into the pipeline. ### Can I limit what my agent is allowed to do with the VA Benefits Intake API? Yes. Because Jentic One is self-hosted, you set the rules that decide which operations and credentials your agent may use, and the Benefits Intake API scopes work by operation rather than by a resource id in the path. That means you can allow only the calls the agent needs, such as requesting an upload location and submitting a claim document with POST /uploads and checking status with GET /uploads/{id}, while withholding others like GET /uploads/report or POST /uploads/validate_document. Anything outside the set you permit simply does not run.