For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
    • Home
  • API Reference
  • Guides
    • Minor ID Setup
    • Architecture
    • Security & Governance
    • PRODA
    • DVA Integration
    • AIR Integration
    • Integration test data
    • Troubleshooting
LogoLogo
On this page
  • Who DVA covers
  • Veteran cards
  • Veteran File Number
  • Verification
  • Claiming
  • Reports
  • Treatment Service Voucher
  • Status codes
Guides

DVA Integration

Department of Veterans’ Affairs — veteran cards, identifiers, and shared concepts

||View as Markdown|
Was this page helpful?
Previous

PRODA

Next

AIR Integration

Built with

Who DVA covers

The Department of Veterans’ Affairs (DVA) funds healthcare for eligible Australian veterans and their dependants. Patients are identified by a DVA file number and a veteran card rather than a Medicare card, and benefits are paid by DVA instead of Medicare. Claims travel through the same Services Australia infrastructure RebateRight uses for other claim types.

For DVA’s own provider guidance, see Providing Treatment to DVA Clients.

Veteran cards

DVA issues three veteran cards. Each covers different conditions and benefits.

CardEntitlement codeCovers
GoldPTECTreatment for all medical conditions, not just service-related. Usually free when the provider accepts the card.
WhiteSTECTreatment for specific service-related conditions listed on the card. Some treatments may need DVA pre-approval.
OrangeRPBCPharmaceutical concessions only — Repatriation Pharmaceutical Benefits Scheme, wound-care items, nutritional supplements. Not for medical or healthcare treatment.

Two further codes can come back on a verification, plus a fallback:

CodeMeaning
PCCPensioner Concession Card (Centrelink-issued; not DVA-specific).
CSHCCommonwealth Seniors Healthcare Card.
NILCard type cannot be determined — advise the patient to contact DVA.

DVA’s own pages: Gold Card · White Card · Orange Card.

Veteran File Number

The DVA file number identifies the veteran. Format: a war code (alpha prefix) followed by numeric digits, no spaces — for example NX901667. Treat as case-sensitive.

Verification

Run Veteran Verification before claiming. Two flows:

  • PVP — verify by personal details. Submit name, DOB, sex; DVA returns the file number and card type.
  • PVV — verify against a known file number. Include veteranMembership.veteranNumber alongside the personal details.

Verification returns a numeric status.code (see Status codes).

Claiming

DVA medical claims split by service type:

serviceTypeCodeFor
OGeneral / out-of-hospital services
SSpecialist services
PPathology services

Each medical event requires an acceptedDisability block naming the condition treated. Set ind to Y for White Card holders; code is free text describing the condition.

On success, claim submission returns a claim ID in the format A0001@ — letter prefix + four numerics + @. The prefix indicates the claim’s service type and channel.

Reports

After lodging a claim, retrieve the outcome via DVA Processing Report (assessment + line-level detail) and DVA Payment Report (payment run + amounts). Both reports are available for a 6-month retrieval window from claim submission.

Treatment Service Voucher

The Service Voucher D1216S (PDF) generates a printable treatment service voucher for the veteran to keep. It does not lodge a claim — use it when your workflow needs a paper or saved copy of the visit and services.

Status codes

DVA endpoints return a numeric status in status.code (verification) or serviceMessage[].code (claims and reports). Common values:

CodeMeaning
0Success — patient/claim matched DVA records.
8005Patient verification accepted, but details didn’t exactly match DVA records. Correct before claiming.
9202Field-level validation failure — see serviceMessage for detail.
9650Veteran File Number and/or details didn’t match.
9006Provider not authorised for this function.
9777Duplicate transaction ID — resubmit with a unique correlationId.
3004Daily claim limit of 2,500 reached for this payee provider and location.