API reference / Admin

patch/v1/admin/visa-data/{destination}/availability

Show or hide every product for one destination

Operation
adminUpdateDestinationAvailability
Authentication
API key

The switch to reach for when an authority stops accepting applications: one call takes all of that destination’s visa types out of the catalogue and blocks new applications on them, in one transaction and one audit entry. Existing applications keep their saved quote.

Request

Parameters

destinationpathrequiredstring

Body

activebooleanrequired

Responses

200Updated destination availability.

Free-form JSON object.

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 PATCH https://api.haavisa.com/v1/admin/visa-data/<destination>/availability \
  -H "Authorization: Bearer $HAAVISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "active": true
  }'

More in Admin

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