Check submission readiness

All submission blockers, canSubmit, next actions within the signed-in identity’s authorized resources.

GET/api/v1/traveler/cases/{id}/readiness

Authorization

Use Authorization: Bearer with a customer access token. Every resource must belong to the signed-in identity’s authorized set.

traveler:cases:read

Request headers

AuthorizationBearer · required: A Wincora customer access token for the Traveler audience.

Path parameters

idstring · required: Opaque identifier in the authorized resource scope. Nested identifiers must belong to their parent resource.

Response

200OK

Returns the authorized resource or result for this operation. List results use items, nextCursor, and hasMore.

Behavior to account for

Every resource is filtered by the signed-in identity’s current relationships. Customer-account membership alone grants no access. Tokens cannot call Tenant or Visa Intelligence endpoints.

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

REQUESTCustomer token

curl --request GET 'https://api.wincora.com/api/v1/traveler/cases/id_example/readiness' \
  --header 'Authorization: Bearer CUSTOMER_ACCESS_TOKEN'

const response = await fetch('https://api.wincora.com/api/v1/traveler/cases/id_example/readiness', {
  method: 'GET',
  headers: {
    "Authorization": "Bearer " + process.env.WINCORA_CUSTOMER_TOKEN
  }
});

if (!response.ok) throw new Error(await response.text());
const result = await response.json();

import os
import requests

response = requests.request(
    'GET',
    'https://api.wincora.com/api/v1/traveler/cases/id_example/readiness',
    headers={
      "Authorization": "Bearer " + os.environ["WINCORA_CUSTOMER_TOKEN"]
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()

RESPONSE EXAMPLE200

{
  "caseId": "case_example",
  "canSubmit": false,
  "resubmissionRequired": false,
  "blockers": [
    {
      "code": "document_missing",
      "requirementId": "passport.identityPage"
    }
  ],
  "nextActions": [
    "uploadDocument"
  ]
}

Keep the customer token in memory or behind your backend. Never put it in URLs, logs, or persistent browser storage.