Navii Pro

Use your Navii Pro license key to unlock premium API options such as themed packs while the free API stays anonymous and backwards-compatible.

Get a license

Buy Navii Pro at https://navii.dev/pro. Today that URL sends you straight to checkout; later it may become a pricing page. API clients should keep linking to it either way.

After purchase, Polar emails your license key. The same key unlocks the Figma plugin and Pro-only hosted API options.

API auth

Pass the license key as a bearer token when you request a Pro-only option:

curl -H "Authorization: Bearer <license_key>" \
  "https://api.navii.dev/avatar/alice?packs=halloween"

Keep using ordinary unauthenticated URLs for free options:

https://api.navii.dev/avatar/alice?size=128

What requires Pro

Option	Auth required?	Notes
`packs=...`	Yes	Premium themed packs such as `halloween`, `office`, and future pack drops.
`pro=1`	Yes	Auth probe for testing whether a license key is accepted. Renders the same avatar after auth succeeds.
Base avatar params	No	`size`, `palette`, `background`, `mood`, `animated`, `tileBg`, and `title` stay anonymous.

Error responses

Missing Pro auth returns 401 with an upgrade URL:

{
  "error": "pro_auth_required",
  "message": "This option requires Navii Pro. Get a license at https://navii.dev/pro.",
  "upgradeUrl": "https://navii.dev/pro"
}

Invalid, revoked, expired, or wrong-product keys return 401:

{
  "error": "invalid_license",
  "message": "The Navii Pro license key is invalid or inactive. Get a license at https://navii.dev/pro.",
  "upgradeUrl": "https://navii.dev/pro"
}

If Polar cannot be reached or returns an invalid response, Navii returns 502:

{
  "error": "license_check_unavailable",
  "message": "License verification is temporarily unavailable."
}

Security notes

Do not put a license key in public frontend code unless you are comfortable with users seeing it.
Prefer server-side calls, CLI usage, build scripts, or backend SDK helpers for Pro API requests.
License checks are cached in-process for 24 hours to keep rendering fast and avoid hitting Polar on every avatar request.