Verify API key

Overview

Use this endpoint to verify that your API key is valid and active. It returns key metadata without consuming a chat completion request.

POST/v1/verify-key

This endpoint requires a Bearer token in the Authorization header:

Authorization: Bearer sk_unii_your_api_key_here

Authorization: Bearer sk_unii_your_api_key_here

curl -X POST https://api.unii.dev/v1/verify-key \
-H "Authorization: Bearer $UNII_API_KEY"

curl -X POST https://api.unii.dev/v1/verify-key \-H "Authorization: Bearer $UNII_API_KEY"

A valid API key returns a JSON object with key metadata:

response.json

{
"valid": true,
"keyPrefix": "sk_unii_...",
"createdAt": "2025-01-15T10:30:00Z"
}

response.json

{"valid": true,"keyPrefix": "sk_unii_...","createdAt": "2025-01-15T10:30:00Z"}

Status code	Meaning
401	The API key is missing, invalid, or expired
403	The API key is valid but has been revoked

error.json

{
"error": {
  "message": "Invalid API key.",
  "type": "authentication_error",
  "code": 401
}
}

error.json

{"error": {  "message": "Invalid API key.",  "type": "authentication_error",  "code": 401}}

Tip

Call this endpoint during application startup to fail fast if the API key is invalid, rather than waiting for the first chat completion to fail.