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
        • POSTIdentify Individual
        • POSTImmunisation History Details
        • POSTMedical Contraindication History
        • POSTNatural Immunity History
        • POSTVaccine Trial History
        • POSTAdd Additional Vaccine Indicator
        • POSTRemove Additional Vaccine Indicator
        • POSTIndigenous Status Update
        • POSTImmunisation History Statement
        • POSTUpdate Encounter
  • Guides
    • Minor ID Setup
    • Architecture
    • Security & Governance
    • PRODA
    • DVA Integration
    • AIR Integration
    • Integration test data
    • Troubleshooting
LogoLogo
API ReferenceAIRIndividual Details

Natural Immunity History

||View as Markdown|
POST
/AIR/v1/individual/natural-immunity/history
POST
/AIR/v1/individual/natural-immunity/history
$curl -X POST https://api.rebateright.com.au/AIR/v1/individual/natural-immunity/history \
>     -H "x-api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "individualIdentifier": "wXrN7bKidsrEkh89yldqZRw99uzP6WZJfEgIe4PEaEQ1TyUZsqOSEnqCM0BvbRF-FoHdgZgtg4iynmUuQamZdgGPH8QDag8rwFax7MI0zBpBaQnsaznfCA==",
>  "individualDateOfBirth": "17042012",
>  "informationProvider": {
>    "providerNumber": "T39126X"
>  }
>}'
200With History
1{
2  "statusCode": "AIR-I-1100",
3  "codeType": "AIRIBU",
4  "message": "Your request was successfully processed.",
5  "naturalImmunityList": [
6    {
7      "disease": "HEP",
8      "notificationDate": "14122021",
9      "labTestDate": "14122021",
10      "diagnosisDate": "14122021"
11    },
12    {
13      "disease": "VAR",
14      "notificationDate": "10032022",
15      "labTestDate": "08032022",
16      "diagnosisDate": ""
17    },
18    {
19      "disease": "MUM",
20      "notificationDate": "21032022",
21      "labTestDate": "01022022",
22      "diagnosisDate": "02032022"
23    },
24    {
25      "disease": "MEA",
26      "notificationDate": "14042022",
27      "labTestDate": "11042022",
28      "diagnosisDate": "14042022"
29    },
30    {
31      "disease": "RUB",
32      "notificationDate": "13102022",
33      "labTestDate": "11102022",
34      "diagnosisDate": "12102022"
35    }
36  ],
37  "correlationId": "urn:uuid:MDE00000f456373cea204dba"
38}
Retrieve the individual's recorded natural immunities — diseases they're assessed as immune to, with notification, lab test, and diagnosis dates. Requires an `individualIdentifier` from a prior [Identify Individual](/api-reference/air/individual-details/identify-individual) call. If `naturalImmunityIndicator` 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. `naturalImmunityList` 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. |
Was this page helpful?
Previous

Medical Contraindication History

Next

Vaccine Trial History

Built with

Retrieve the individual’s recorded natural immunities — diseases they’re assessed as immune to, with notification, lab test, and diagnosis dates.

Requires an individualIdentifier from a prior Identify Individual call. If naturalImmunityIndicator 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.

Date format

Date fields use DDMMYYYY with no separators.

Status Codes

Top-level outcomes for this endpoint:

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

Authentication

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

Request

This endpoint expects an object.
individualIdentifierstringRequired
Opaque token from a prior Identify Individual call.
individualDateOfBirthstringRequired

DDMMYYYY format. Must match the individual matched by individualIdentifier.

informationProviderobjectRequired

Response

OK
statusCodestring
codeTypestring
messagestring
naturalImmunityListlist of objects
Recorded natural immunities. The whole field is omitted when no records exist.
errorslist of objects or null

Field-level validation problems. See Validation codes.

correlationIdstring
Unique request identifier.