UnifyUnitsDevelopers

Authentication

Conversion endpoints require a Bearer API key. Discovery endpoints (/v1/categories,/v1/units,/v1/health,/openapi.json) are public.

http
Authorization: Bearer uu_live_xxxxxxxxxxxxxxxxxxxxxxxxxx
Key format. Production keys use theuu_live_ prefix and contain 32 cryptographically random bytes. Treat them like passwords.
Do not embed API keys in public browser or mobile code.Use keys server-side only, or call public discovery endpoints without authentication.

Create an API key →

Endpoint access table

EndpointAuthentication
GET /v1/convertBearer
POST /v1/convertBearer
POST /v1/batchBearer
GET /v1/categoriesPublic
GET /v1/categories/:categoryPublic
GET /v1/unitsPublic
GET /v1/units/:unitPublic
GET /v1/healthPublic
GET /openapi.jsonPublic

Key rotation

  1. Open your account page and rotate the key
  2. Deploy your service with the new key
  3. Verify traffic is flowing correctly
  4. Confirm the previous key is revoked

Use separate keys for separate environments. Never reuse a key across production and development.