SMAO API Documentation
Public APICalls & recordings

Get a call with transcript, analyses, and notes

GET
/calls/{call_id}
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Path Parameters

call_idstring
Match^[a-f0-9]{24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.smao.ai/api/v1/calls/string"
{
  "data": {
    "id": "string",
    "assistant_id": "string",
    "assistant_name": "string",
    "assistant_phone": "string",
    "direction": "inbound",
    "source": "inbound_phone",
    "phone_number": "string",
    "duration_seconds": 0,
    "done": true,
    "success": true,
    "language": "string",
    "started_at": "2019-08-24T14:15:22Z",
    "ended_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "transcript": [
      {
        "role": "assistant",
        "content": "string",
        "timestamp": "2019-08-24T14:15:22Z"
      }
    ],
    "analyses": [
      {
        "id": "string",
        "name": "string",
        "status": "completed",
        "body_result": {},
        "started_at": "2019-08-24T14:15:22Z",
        "completed_at": "2019-08-24T14:15:22Z"
      }
    ],
    "notes": [
      {
        "id": "string",
        "content": "string",
        "author_id": "string",
        "author_name": "string",
        "created_at": "2019-08-24T14:15:22Z"
      }
    ],
    "recording": {
      "available": true,
      "format": "flac",
      "mime_type": "audio/flac",
      "duration_ms": 0,
      "size_bytes": 0
    }
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "Validation failed"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Missing API key"
  }
}
{
  "error": {
    "code": "subscription_required",
    "message": "This feature is not available in your current subscription. Please upgrade to a higher plan"
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "No permission"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not found"
  }
}
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded"
  }
}
{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred."
  }
}