API reference / Applications

put/v1/applications/{id}/requirements

Provide a host code or insurance reference

Operation
putApplicationRequirements
Authentication
API key

Request

Parameters

idpathrequiredstring

Body

keystringrequired

one of: reference_codetravel_health_insurance

valuestringrequired

Responses

200Requirement records. Applicant provision is not operator verification.
idstringrequired
keystringrequired

one of: reference_codetravel_health_insurance

statusstringrequired

one of: pendingprovidedverifiedexempt

requiredbooleanrequired
detailsobjectrequired
reviewed_bystringnullrequired
updated_atstringrequired
400The request body or query failed validation.
errorobjectrequired
401No key, an unknown key, a revoked key, or a key whose tenant is not active. All four return an identical body on purpose: distinguishing them would let a caller discover which partners we have.
errorobjectrequired
403`projects:write` is required. No partner key is ever issued this scope.
errorobjectrequired
404Not found, or not yours. A resource belonging to another tenant answers 404 rather than 403, because 403 would confirm the record exists.
errorobjectrequired

Example

curl
curl -X PUT https://api.haavisa.com/v1/applications/<id>/requirements \
  -H "Authorization: Bearer $HAAVISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "reference_code",
    "value": "<value>"
  }'

More in Applications

Something unclear? The eligibility guide explains the model behind the answers; the errors guide covers the envelope.