> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allomia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> Build powerful healthcare AI integrations with the AlloMia API

## Overview

The AlloMia API enables you to integrate our advanced healthcare AI capabilities directly into your applications and workflows. Our RESTful API provides programmatic access to voice agents, knowledge bases, and healthcare organization management features.

## Getting Started

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/profile-authentication/authentication-methods">
    Learn how to authenticate your API requests with Bearer tokens
  </Card>

  <Card title="API Endpoints" icon="code" href="/api-reference/endpoint/create-organization">
    Explore our comprehensive API endpoints
  </Card>
</CardGroup>

## Core Resources

<CardGroup cols={3}>
  <Card title="Organizations" icon="building" href="/api-reference/endpoint/organization">
    Create and manage healthcare organizations
  </Card>

  <Card title="Voice Agents" icon="microphone" href="/api-reference/endpoint/voice-agents">
    Configure and control AI voice assistants
  </Card>

  <Card title="Knowledge Base" icon="database" href="/api-reference/endpoint/knowledge-base">
    Manage your AI knowledge sources
  </Card>
</CardGroup>

## Authentication

All API requests require authentication using a tenant-specific API key. Include this key in the Authorization header of your requests using the Bearer token format:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

API keys are specific to your organization and environment. Contact your administrator or the AlloMia support team to obtain the appropriate API credentials for your integration needs.

## Response Format

All API responses are returned in JSON format. Successful requests return a `2xx` status code, while errors return an appropriate HTTP status code (`4xx` for client errors, `5xx` for server errors) along with an error message in the response body.

```json theme={null}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key provided"
  }
}
```

## Rate Limits

To ensure service stability, the AlloMia API implements rate limiting on all endpoints. If you exceed the rate limit, you'll receive a `429 Too Many Requests` response. Implement appropriate backoff strategies in your applications to handle these cases gracefully.