Skip to navigation
RebateRight APIDVA

DVA Claim — Specialist

How do I lodge a DVA claim for specialist services?

Use this endpoint. Each medical event must meet the referral requirement below.

Submit a DVA specialist claim. Set serviceTypeCode to S.

Referral Requirement

Each medical event must satisfy one of:

  • A specialist or diagnostic imaging referral (referral with typeCode: S or D)
  • A referralOverrideCode of H, L, E or N
  • A selfDeemedCode of SD or SS on at least one service

When referral.typeCode is S, referral.periodCode must also be set. The standard period is 12 months for a referral from a general practitioner, and 3 months for a referral from a specialist.

Hyperbaric Items

A claim for a hyperbaric item must send timeDuration, with the start and end times of the item in the service text. Together they determine the number of time units (hours) for the service.

Retained Referral Details

Your software must keep the referral details for each patient, for reuse on later consultations.

For the claim ID format, see DVA claims. For the status codes, including what to do on 9777 and 3004, see Status codes. If a claim gets no response, follow When a claim gets no response, which also gives the client timeout to set.

Authentication

x-api-keystring
API Key authentication via header
x-minor-idstring

Your Minor ID is 3 uppercase letters followed by 5 digits, such as MDE00000. Send the Minor ID exactly as issued. A malformed value returns 400 with the text The Minor ID is not valid. on every endpoint.

Headers

x-minor-idstringRequired

The Minor ID of the clinic you act for. See Keys, Minor ID and environments.

Request

This endpoint expects an object.
claimobjectRequired
correlationIdstringOptionalformat: "^urn:uuid:[A-Z]{3}[0-9]{5}[A-Za-z0-9]{16}$"=33 characters

Your identifier for this claim, 33 characters: urn:uuid:, then the Minor ID you send in x-minor-id, then 16 letters or digits, as in urn:uuid:MDE00000a1b2c3d4e5f6a7b8.

Send your own on every claim, and store it before you send. You fetch the claim’s processing and payment reports with it. If you omit it, RebateRight generates one. When to use a new value and when to reuse one is set out in Correlation ID.

Response

OK
claimIdstringOptional

Unique claim identifier assigned by Services Australia (for example D0745@).

statusstringOptional

Always SUCCESS on a successful submission.

correlationIdstringOptional

Errors

400
Bad Request Error