Vaccine Trial History

View as Markdown
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. |

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
vaccineTrialListlist of objects
Recorded vaccine trials. 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.