Credential route catalog

{
  "schema_version": "1",
  "ledger_updated_at": "2026-07-16",
  "environment": "sandbox",
  "countries": [
    {
      "code": "UT",
      "name": "Utopia",
      "test": true,
      "routes": [{
        "route_key": "UT/google-wallet/utopia-id-pass",
        "provider_id": "google-wallet",
        "credential_profile_id": "utopia-id-pass",
        "status": "sandbox",
        "coverage": "test",
        "registration_required": false,
        "source_url": "https://developers.google.com/wallet/identity/verify/supported-issuers-iaca-certs",
        "available": true
      }]
    }
  ],
  "onboarding_requirements": [{
    "id": "google-verifier-registrar-client",
    "provider_id": "google-wallet",
    "label": "Google Wallet relying-party enrollment",
    "mode": "alentra_managed",
    "customer_action_required": false
  }],
  "providers": [{
    "id": "google-wallet",
    "label": "Google Wallet",
    "enabled": true,
    "adapter_available": true
  }],
  "credential_profiles": [{
    "id": "utopia-id-pass",
    "label": "Utopia ID Pass",
    "format": "mdoc",
    "doc_type": "com.google.wallet.idcard.1",
    "namespace": "org.iso.18013.5.1",
    "default_country": "UT"
  }],
  "wallets": [{
    "id": "google-wallet",
    "label": "Google Wallet",
    "available": true,
    "primitives": { "identify": true, "age_verify": true, "light_sign": true, "sign": true }
  }],
  "primitives": [
    { "id": "identify", "available": true },
    { "id": "age_verify", "available": true },
    { "id": "light_sign", "available": true },
    { "id": "sign", "available": true }
  ]
}

{
  "schema_version": "1",
  "ledger_updated_at": "2026-07-16",
  "environment": "sandbox",
  "countries": [
    {
      "code": "UT",
      "name": "Utopia",
      "test": true,
      "routes": [{
        "route_key": "UT/google-wallet/utopia-id-pass",
        "provider_id": "google-wallet",
        "credential_profile_id": "utopia-id-pass",
        "status": "sandbox",
        "coverage": "test",
        "registration_required": false,
        "source_url": "https://developers.google.com/wallet/identity/verify/supported-issuers-iaca-certs",
        "available": true
      }]
    }
  ],
  "onboarding_requirements": [{
    "id": "google-verifier-registrar-client",
    "provider_id": "google-wallet",
    "label": "Google Wallet relying-party enrollment",
    "mode": "alentra_managed",
    "customer_action_required": false
  }],
  "providers": [{
    "id": "google-wallet",
    "label": "Google Wallet",
    "enabled": true,
    "adapter_available": true
  }],
  "credential_profiles": [{
    "id": "utopia-id-pass",
    "label": "Utopia ID Pass",
    "format": "mdoc",
    "doc_type": "com.google.wallet.idcard.1",
    "namespace": "org.iso.18013.5.1",
    "default_country": "UT"
  }],
  "wallets": [{
    "id": "google-wallet",
    "label": "Google Wallet",
    "available": true,
    "primitives": { "identify": true, "age_verify": true, "light_sign": true, "sign": true }
  }],
  "primitives": [
    { "id": "identify", "available": true },
    { "id": "age_verify", "available": true },
    { "id": "light_sign", "available": true },
    { "id": "sign", "available": true }
  ]
}

GET https://api.alentra.app/v1/catalog · Public · No API key · No charge

The canonical discovery ledger for jurisdiction, credential profile, presentation provider, onboarding requirements, rollout state, and runtime availability. Use it instead of hard-coding a country-to-wallet relationship: one country may have several routes, and one wallet provider may present credentials from several countries. The endpoint is public, CORS-readable, and cached for up to five minutes.

Response

string

Catalog response schema version.

string

Date the source-controlled coverage ledger was last verified.

string

development, sandbox, or production.

object[]

Every tracked jurisdiction. Coming-soon routes remain visible so absence and pending onboarding are distinguishable.

Show country

string

ISO 3166-1 alpha-2 code; UT is the explicit fictional Utopia sandbox jurisdiction.

string

Display name.

boolean

True only for a fictional test jurisdiction.

object[]

Show route

string

Stable business-selection key: country/provider/profile.

string

Presentation provider, e.g. google-wallet.

string

Credential/trust profile, e.g. utopia-id-pass.

string

sandbox, live, or coming_soon.

string

national, partial, or test.

string[]

Optional sub-jurisdictions for partial coverage, such as supported US mDL issuers.

boolean

Whether provider/issuer onboarding is still required.

string[]

Deduplicated provider/issuer requirements this route needs.

string

Official source used to verify the route.

string

A route-specific limitation, when present.

boolean

The only field that means this exact route can start in the current environment.

object[]

Fixed requirement records referenced by routes. Each includes a stable id, provider, label, mode (alentra_managed, alentra_managed_provider_review, or waitlist), whether customer action is required, customer/Alentra summaries, and an official source URL. These records explain onboarding; they do not make a route available.

object[]

Provider labels plus enabled (allowed by this deployment) and adapter_available (transport code registered at runtime).

object[]

Stable profile ids and their format, doctype, namespace, and fallback issuing country. Blank protocol fields mean onboarding/acceptance is incomplete and the profile cannot become available.

object[]

Legacy provider capability projection: provider id/label, adapter availability, and per-primitive booleans. Route selection must still use countries[].routes.

object[]

Shipped primitive ids and whether any registered provider adapter implements them.

{
  "schema_version": "1",
  "ledger_updated_at": "2026-07-16",
  "environment": "sandbox",
  "countries": [
    {
      "code": "UT",
      "name": "Utopia",
      "test": true,
      "routes": [{
        "route_key": "UT/google-wallet/utopia-id-pass",
        "provider_id": "google-wallet",
        "credential_profile_id": "utopia-id-pass",
        "status": "sandbox",
        "coverage": "test",
        "registration_required": false,
        "source_url": "https://developers.google.com/wallet/identity/verify/supported-issuers-iaca-certs",
        "available": true
      }]
    }
  ],
  "onboarding_requirements": [{
    "id": "google-verifier-registrar-client",
    "provider_id": "google-wallet",
    "label": "Google Wallet relying-party enrollment",
    "mode": "alentra_managed",
    "customer_action_required": false
  }],
  "providers": [{
    "id": "google-wallet",
    "label": "Google Wallet",
    "enabled": true,
    "adapter_available": true
  }],
  "credential_profiles": [{
    "id": "utopia-id-pass",
    "label": "Utopia ID Pass",
    "format": "mdoc",
    "doc_type": "com.google.wallet.idcard.1",
    "namespace": "org.iso.18013.5.1",
    "default_country": "UT"
  }],
  "wallets": [{
    "id": "google-wallet",
    "label": "Google Wallet",
    "available": true,
    "primitives": { "identify": true, "age_verify": true, "light_sign": true, "sign": true }
  }],
  "primitives": [
    { "id": "identify", "available": true },
    { "id": "age_verify", "available": true },
    { "id": "light_sign", "available": true },
    { "id": "sign", "available": true }
  ]
}

The real response includes the full ledger, not only the Utopia excerpt above. Never offer a route unless its own available value is true; provider adapter availability alone is insufficient.

Overview

Sessions

Audits

Discovery

Webhooks

Response

​Response

Response