somaa API Reference

Welcome to the somaa API documentation. This guide explains how to use the somaa API to integrate leadership development features into your applications.

Errors

somaa uses conventional HTTP response codes to indicate the success or failure of API requests.

Error Code Description
401 - Unauthorized Invalid API key or authentication token
403 - Forbidden Insufficient permissions
404 - Not Found Resource not found
429 - Too Many Requests Rate limit exceeded
500 - Server Error Internal server error 
{
    "error": {
        "code": "rate_limit_exceeded",
        "message": "You have exceeded your API rate limit",
        "doc_url": "https://docs.somaa.com/rate-limits",
        "status": 429
    }
}

Rate Limits

Plan Rate Limit Burst Limit
Developer 100 requests/minute 150 requests
Professional 500 requests/minute 750 requests
Enterprise Custom Custom
Back to Home