> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.rebateright.com.au/llms.txt.
> For full documentation content, see https://docs.rebateright.com.au/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rebateright.com.au/_mcp/server.

# Vaccine Trial History

POST https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history
Content-Type: application/json

Retrieve vaccine trials the individual is participating in or has participated in, with the antigen code, dose, and trial period.

Requires an `individualIdentifier` from a prior [Identify Individual](/api-reference/air/individual-details/identify-individual) call. If `vaccineTrialIndicator` on that response is `false`, this endpoint returns success with no list field.

For shared response patterns and the full status-code list, see [AIR Integration](/air).

#### Date format

Date fields use **DDMMYYYY** with no separators.

#### Status Codes

Top-level outcomes for this endpoint:

| Code | Meaning |
|---|---|
| `AIR-I-1100` | Request was successfully processed. `vaccineTrialList` returned (omitted entirely when no records exist). |
| `AIR-E-1005` | Validation errors (e.g. `AIR-E-1061` invalid or expired identifier). |
| `AIR-E-1058` | Individual's record cannot be viewed or updated. |


Reference: https://docs.rebateright.com.au/api-reference/air/individual-details/vaccine-trial-history

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: collection
  version: 1.0.0
paths:
  /AIR/v1/individual/vaccine-trial/history:
    post:
      operationId: vaccine-trial-history
      summary: Vaccine Trial History
      description: >
        Retrieve vaccine trials the individual is participating in or has
        participated in, with the antigen code, dose, and trial period.


        Requires an `individualIdentifier` from a prior [Identify
        Individual](/api-reference/air/individual-details/identify-individual)
        call. If `vaccineTrialIndicator` on that response is `false`, this
        endpoint returns success with no list field.


        For shared response patterns and the full status-code list, see [AIR
        Integration](/air).


        #### Date format


        Date fields use **DDMMYYYY** with no separators.


        #### Status Codes


        Top-level outcomes for this endpoint:


        | Code | Meaning |

        |---|---|

        | `AIR-I-1100` | Request was successfully processed. `vaccineTrialList`
        returned (omitted entirely when no records exist). |

        | `AIR-E-1005` | Validation errors (e.g. `AIR-E-1061` invalid or expired
        identifier). |

        | `AIR-E-1058` | Individual's record cannot be viewed or updated. |
      tags:
        - subpackage_air.subpackage_air/individualDetails
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AIR_Individual Details_Vaccine Trial
                  History_Response_200
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                individualIdentifier:
                  type: string
                  description: Opaque token from a prior Identify Individual call.
                individualDateOfBirth:
                  type: string
                  description: >-
                    DDMMYYYY format. Must match the individual matched by
                    `individualIdentifier`.
                informationProvider:
                  $ref: >-
                    #/components/schemas/AirV1IndividualVaccineTrialHistoryPostRequestBodyContentApplicationJsonSchemaInformationProvider
              required:
                - individualIdentifier
                - individualDateOfBirth
                - informationProvider
servers:
  - url: https://api.rebateright.com.au
  - url: https://test-api.rebateright.com.au
components:
  schemas:
    AirV1IndividualVaccineTrialHistoryPostRequestBodyContentApplicationJsonSchemaInformationProvider:
      type: object
      properties:
        providerNumber:
          type: string
          description: Medicare or AIR provider number.
        hpioNumber:
          type: string
          description: Optional. HPI-O. 16 digits.
        hpiiNumber:
          type: string
          description: Optional. HPI-I. 16 digits.
      required:
        - providerNumber
      title: >-
        AirV1IndividualVaccineTrialHistoryPostRequestBodyContentApplicationJsonSchemaInformationProvider
    AirV1IndividualVaccineTrialHistoryPostResponsesContentApplicationJsonSchemaVaccineTrialListItems:
      type: object
      properties:
        antigenCode:
          type: string
          description: >-
            1–6 character antigen code (refer to the AIR Vaccine Code Formats
            guide).
        dose:
          type: string
          description: >-
            Dose number — same value set as `vaccineDose` on encounters (`B`,
            `1`–`20`, `V`).
        startDate:
          type: string
          description: DDMMYYYY format. Date the trial commenced.
        endDate:
          type: string
          description: DDMMYYYY format, or empty string while the trial is ongoing.
      title: >-
        AirV1IndividualVaccineTrialHistoryPostResponsesContentApplicationJsonSchemaVaccineTrialListItems
    AirV1IndividualVaccineTrialHistoryPostResponsesContentApplicationJsonSchemaErrorsItems:
      type: object
      properties:
        code:
          type: string
        field:
          type: string
        message:
          type: string
      title: >-
        AirV1IndividualVaccineTrialHistoryPostResponsesContentApplicationJsonSchemaErrorsItems
    AIR_Individual Details_Vaccine Trial History_Response_200:
      type: object
      properties:
        statusCode:
          type: string
        codeType:
          type: string
        message:
          type: string
        vaccineTrialList:
          type: array
          items:
            $ref: >-
              #/components/schemas/AirV1IndividualVaccineTrialHistoryPostResponsesContentApplicationJsonSchemaVaccineTrialListItems
          description: >-
            Recorded vaccine trials. The whole field is omitted when no records
            exist.
        errors:
          type:
            - array
            - 'null'
          items:
            $ref: >-
              #/components/schemas/AirV1IndividualVaccineTrialHistoryPostResponsesContentApplicationJsonSchemaErrorsItems
          description: >-
            Field-level validation problems. See [Validation
            codes](/air#validation-codes).
        correlationId:
          type: string
          description: Unique request identifier.
      title: AIR_Individual Details_Vaccine Trial History_Response_200
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
    minorId:
      type: apiKey
      in: header
      name: x-minor-id

```

## SDK Code Examples

```python With History
import requests

url = "https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history"

payload = {
    "individualIdentifier": "wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==",
    "individualDateOfBirth": "17042012",
    "informationProvider": { "providerNumber": "T39126X" }
}
headers = {
    "x-api-key": "<apiKey>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript With History
const url = 'https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history';
const options = {
  method: 'POST',
  headers: {'x-api-key': '<apiKey>', 'Content-Type': 'application/json'},
  body: '{"individualIdentifier":"wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==","individualDateOfBirth":"17042012","informationProvider":{"providerNumber":"T39126X"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go With History
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history"

	payload := strings.NewReader("{\n  \"individualIdentifier\": \"wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==\",\n  \"individualDateOfBirth\": \"17042012\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<apiKey>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby With History
require 'uri'
require 'net/http'

url = URI("https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<apiKey>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"individualIdentifier\": \"wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==\",\n  \"individualDateOfBirth\": \"17042012\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java With History
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history")
  .header("x-api-key", "<apiKey>")
  .header("Content-Type", "application/json")
  .body("{\n  \"individualIdentifier\": \"wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==\",\n  \"individualDateOfBirth\": \"17042012\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}")
  .asString();
```

```php With History
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history', [
  'body' => '{
  "individualIdentifier": "wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==",
  "individualDateOfBirth": "17042012",
  "informationProvider": {
    "providerNumber": "T39126X"
  }
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'x-api-key' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp With History
using RestSharp;

var client = new RestClient("https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history");
var request = new RestRequest(Method.POST);
request.AddHeader("x-api-key", "<apiKey>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"individualIdentifier\": \"wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==\",\n  \"individualDateOfBirth\": \"17042012\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift With History
import Foundation

let headers = [
  "x-api-key": "<apiKey>",
  "Content-Type": "application/json"
]
let parameters = [
  "individualIdentifier": "wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==",
  "individualDateOfBirth": "17042012",
  "informationProvider": ["providerNumber": "T39126X"]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

```python No History
import requests

url = "https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history"

payload = {
    "individualIdentifier": "wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==",
    "individualDateOfBirth": "18042016",
    "informationProvider": { "providerNumber": "T39126X" }
}
headers = {
    "x-api-key": "<apiKey>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript No History
const url = 'https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history';
const options = {
  method: 'POST',
  headers: {'x-api-key': '<apiKey>', 'Content-Type': 'application/json'},
  body: '{"individualIdentifier":"wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==","individualDateOfBirth":"18042016","informationProvider":{"providerNumber":"T39126X"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go No History
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history"

	payload := strings.NewReader("{\n  \"individualIdentifier\": \"wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==\",\n  \"individualDateOfBirth\": \"18042016\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<apiKey>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby No History
require 'uri'
require 'net/http'

url = URI("https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<apiKey>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"individualIdentifier\": \"wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==\",\n  \"individualDateOfBirth\": \"18042016\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java No History
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history")
  .header("x-api-key", "<apiKey>")
  .header("Content-Type", "application/json")
  .body("{\n  \"individualIdentifier\": \"wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==\",\n  \"individualDateOfBirth\": \"18042016\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}")
  .asString();
```

```php No History
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history', [
  'body' => '{
  "individualIdentifier": "wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==",
  "individualDateOfBirth": "18042016",
  "informationProvider": {
    "providerNumber": "T39126X"
  }
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'x-api-key' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp No History
using RestSharp;

var client = new RestClient("https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history");
var request = new RestRequest(Method.POST);
request.AddHeader("x-api-key", "<apiKey>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"individualIdentifier\": \"wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==\",\n  \"individualDateOfBirth\": \"18042016\",\n  \"informationProvider\": {\n    \"providerNumber\": \"T39126X\"\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift No History
import Foundation

let headers = [
  "x-api-key": "<apiKey>",
  "Content-Type": "application/json"
]
let parameters = [
  "individualIdentifier": "wXrN7bKidsrIHzwqkDkGJHDOYBHbiH_3fEgIe4PEaESYj0qNDFRSdnqCM0BvbRF-9maImeb7tXpSC50uqA-T_wGPH8QDag8rTHC-N11jTan2OY_92X9U6Q==",
  "individualDateOfBirth": "18042016",
  "informationProvider": ["providerNumber": "T39126X"]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.rebateright.com.au/AIR/v1/individual/vaccine-trial/history")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```