Authentication

The AXIFI API uses API keys to authenticate requests. You can view and manage your API keys in the Developer Dashboard.

API Key Format

Your API key will look like this:

axifi_a1b2c3d4_f9e8d7c6b5a49e3c2d1f0e9d8c7b6a5...

API keys follow the format axifi_{prefix}_{secret} where the prefix is 8 hex characters and the secret is 56 hex characters.

Making Authenticated Requests

Include your API key in the X-API-Key header (recommended)

HTTP Header (recommended)

X-API-Key: axifi_a1b2c3d4_f9e8d7c6b5a49e3c...

Alternative: The Authorization: Bearer axifi_a1b2c3d4_... header is also accepted, but X-API-Key is the recommended header.

Example Request

cURL

curl https://api.axifi.ai/v1/compounds \
  -H "X-API-Key: axifi_a1b2c3d4_your_key_here"

JavaScript Example

JavaScript / TypeScript

const response = await fetch("https://api.axifi.ai/v1/compounds", {
  headers: {
    "X-API-Key": "axifi_a1b2c3d4_your_key_here",
    "Content-Type": "application/json",
  },
});

Python Example

Python

import requests

response = requests.get(
    "https://api.axifi.ai/v1/compounds",
    headers={
        "X-API-Key": "axifi_a1b2c3d4_your_key_here",
        "Content-Type": "application/json",
    },
)

Security Best Practices

Never share your API key or commit it to version control
Use environment variables to store your API key
Rotate your API keys periodically
Use different keys for development and production
Revoke compromised keys immediately

API Key Scopes

API keys can have different permission levels based on your plan

read:compoundsAccess compound database

read:documentsAccess research documents

write:chatCreate chat completions

write:toolsUse analysis tools

read:searchPerform semantic search

admin:webhooksManage webhooks (Pro+)