Skip to main content

​
API Reference

Build powerful integrations with the emma API.

​
Base URL

https://api.emma.ai/v1

​
Authentication

All API requests require authentication using an API key. 
curl -X GET "https://api.emma.ai/v1/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get your API key from the emma Dashboard.

​
Quick Start

1

Get your API key

Navigate to Settings > API in the emma dashboard.
2

Make your first request

Test the connection with a simple status check.
3

Explore endpoints

Browse the available endpoints below.

​
Available Endpoints

Sessions

Create and manage conversation sessions.

Messages

Send messages and receive responses.

Knowledge

Manage your knowledge base.

Webhooks

Set up event notifications.

​
Rate Limits

PlanRequests per minute
Free10
Pro100
EnterpriseCustom

​
Response Format

All responses are returned in JSON format: 
{
  "success": true,
  "data": {
    // Response data
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

​
Error Handling

Errors follow a consistent format: 
{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "Description of the error"
  }
}
Status CodeDescription
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Internal Server Error

​
SDKs

Python

pip install emma-sdk

Node.js

npm install @emma/sdk

Go

go get emma.ai/sdk