POST
/
v1
/
intelligence
/
emotions
Analyze Call Emotions
curl --request POST \
  --url https://api.bland.ai/v1/intelligence/emotions \
  --header 'authorization: <authorization>' \
  --header 'content-type: <content-type>' \
  --data '{
  "callId": "<string>"
}'
{
  "data": {
    "status": "success",
    "data": {
      "emotion": "angry",
      "callId": "call_abc123xyz78",
      "analyzedAt": "2025-01-07T00:52:43.960Z"
    }
  },
  "errors": null
}

​
Overview

Use advanced AI to analyze the emotional content of a call recording and determine the dominant emotion expressed during the conversation. This intelligence endpoint processes audio recordings up to 25MB in size and returns the primary detected emotion along with analysis metadata.

​
Headers

​
authorization
string
required

Your API key for authentication.

​
content-type
string
required

Must be set to application/json.

​
Body

​
callId
string
required

The unique identifier of the call to analyze. This should be a call ID from a previous call made through the system.

​
Response

​
data
object

The outer response wrapper.

​
errors
object

Will be null for successful requests. Contains error details when the request fails.

{
  "data": {
    "status": "success",
    "data": {
      "emotion": "angry",
      "callId": "call_abc123xyz78",
      "analyzedAt": "2025-01-07T00:52:43.960Z"
    }
  },
  "errors": null
}

​
Error Responses

  • 413 Payload Too Large: Returned when the audio file exceeds the 25MB size limit
  • 404 Not Found: Returned when the specified call_id does not exist
  • 401 Unauthorized: Returned when the API key is invalid or missing