API reference / Applications

get/v1/applications

List applications

Operation
listApplications
Authentication
API key

Scoped to the authenticated tenant. Keys issued to one tenant can never read or modify another tenant’s resources.

Request

Parameters

limitqueryinteger
cursorquerystring
statusquerystring
created_afterquerystring
destination_iso3querystring
nationality_iso3querystring

Responses

200This tenant’s applications, newest first.
applicationsApplication[]required
next_cursorstringnullrequired
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
403The key is valid but does not hold the scope this route requires.
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 GET https://api.haavisa.com/v1/applications \
  -H "Authorization: Bearer $HAAVISA_API_KEY"

More in Applications

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