Authentication

API Key

All Mimir API endpoints require authentication via an API key passed in the request header.

Header Format

x-mimir-cognito-id-token: Bearer <API_KEY>

Generating an API Key

1. Log in to the Mimir web console at https://us.mjoll.no
2. Navigate to User Settings → API Keys
3. Create a new API key
4. Copy the key — it will not be shown again

Example

curl -s "https://us.mjoll.no/api/v1/search?searchString=*" \
  -H "x-mimir-cognito-id-token: Bearer YOUR_API_KEY_HERE"

Rate Limiting

The API enforces rate limits. If you receive a 429 Too Many Requests response, implement exponential backoff with jitter before retrying.

Recommended retry strategy:

• Max attempts: 3
• Base delay: 200ms
• Max delay: 5000ms
• Jittered exponential backoff
• Also retry on 5xx server errors