Authentication

All Maven API requests are authenticated with API keys passed as Bearer tokens.

API Key Format

mvn_{mode}_{secret}

Component	Description
`mvn`	Fixed prefix
`mode`	`test` or `live` — determines which gateway credentials are used
`secret`	32-character random string

Examples:

Pass your API key as a Bearer token in the Authorization header:

curl -X GET https://api.trymaven.com/v1/auth/check \
  -H "Authorization: Bearer mvn_test_your_key_here"

Test mode places real calls. Use your own phone number as the caller during testing.

Manage API keys in the Maven Dashboard under Settings > API Keys.

Create a key

Click Create Key and select the mode (test or live).

Copy the key

Copy the full key immediately — it will only be shown once.

Store securely

The key is hashed server-side (SHA-256). If you lose it, revoke and create a new one.

Status Code	Meaning
`401`	Invalid API key, expired key, or missing Authorization header
`403`	Key is valid but lacks required scopes
`429`	Rate limit exceeded