VISA INTELLIGENCE · V1
Resolve travel intent Corridor + statement + optional previous focus returns suggested intent/confidence/clarification.
POST /api/v1/intelligence/intent-resolutions
Authorization Use a server-side API key with the listed grants and permitted resource access.
Request body
passportCountrystring · required ISO passport country.
destinationCountrystring · required ISO destination country.
statementstring · required Trip purpose in plain language. Omit personal details.
priorFocusstring · optional Clarification focus returned by a previous call. Response 201 Created
Returns the authorized resource or result for this operation. List results use items, nextCursor, and hasMore.
Errors Authentication failures return 401 or 403. Inaccessible resources return 404. Business and idempotency conflicts return 409. Rate limits return 429 with retry guidance.
Error handling guide REQUEST API key
curl --request POST 'https://api.wincora.com/api/v1/intelligence/intent-resolutions' \ --header 'X-Api-Key: YOUR_API_KEY' \ --header 'Idempotency-Key: request-example-001' \ --header 'Content-Type: application/json' \ --data '{ "passportCountry": "IN", "destinationCountry": "FR", "statement": "A ten-day holiday, with no work activities." }' const response = await fetch ( 'https://api.wincora.com/api/v1/intelligence/intent-resolutions' , { method: 'POST' , headers: { "X-Api-Key" : process.env. WINCORA_API_KEY , "Idempotency-Key" : "request-example-001" , "Content-Type" : "application/json" }, body: JSON . stringify ({ "passportCountry" : "IN" , "destinationCountry" : "FR" , "statement" : "A ten-day holiday, with no work activities." }) }); if ( ! response.ok) throw new Error ( await response. text ()); const result = await response. json (); import os import requests response = requests.request( 'POST' , 'https://api.wincora.com/api/v1/intelligence/intent-resolutions' , headers = { "X-Api-Key" : os.environ[ "WINCORA_API_KEY" ], "Idempotency-Key" : "request-example-001" , "Content-Type" : "application/json" }, json = { "passportCountry" : "IN" , "destinationCountry" : "FR" , "statement" : "A ten-day holiday, with no work activities." }, timeout = 30 , ) response.raise_for_status() result = response.json() Keep this API key on your server. Never embed it in browser or mobile code.
