Skip to main content
GET
/
api
/
v1
/
calls
Get calls
curl --request GET \
  --url https://api.elemente.ai/api/v1/calls \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "in-progress",
  "agentPhone": "+1234567890",
  "agentEmail": "+1234567890",
  "customerPhone": "+1234567890",
  "customerEmail": "+1234567890",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "skillId": "123e4567-e89b-12d3-a456-426614174000",
  "customerName": "John Doe",
  "transcription": "Hello, how can I help you?",
  "recordingUrl": "https://example.com/recording.wav",
  "messages": [
    {
      "sid": "SM1234567890abcdef",
      "timestamp": "2025-03-17T14:30:00Z",
      "sender": "agent",
      "content": "Hello, how can I assist you today?",
      "mediaUrl": "https://example.com/image.jpg",
      "status": "delivered"
    }
  ],
  "duration": "7200"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

​
dateRange
object
Example:
{ "from": "2022-01-01", "to": "2022-01-31" }
​
hrs
number
Example:

24

​
status
enum<string>
Available options:
failed,
voicemail,
ringing,
answer,
completed,
busy,
open,
close,
closed,
resolved,
no-answer,
canceled,
in-progress,
ongoing,
pending,
stalled,
expired,
processing,
queued
Example:

"answer"

​
channel
enum<string>
Available options:
call,
sms,
whatsapp,
email,
webchat
Example:

"call"

​
sanitised
string
Example:

"yes"

Response

Returns the call

​
id
string
required

Interaction ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
status
string
required

Interaction status

Example:

"in-progress"

​
agentPhone
string
required

Agent phone number

Example:

"+1234567890"

​
agentEmail
string
required

Agent Email

Example:

"+1234567890"

​
customerPhone
string
required

Customer phone number

Example:

"+1234567890"

​
customerEmail
string
required

Customer email

Example:

"+1234567890"

​
agentId
string
required

Agent ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
customerId
string
required

Customer ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
skillId
string
required

Skill ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
customerName
string
required

Customer name

Example:

"John Doe"

​
transcription
string
required

Transcription

Example:

"Hello, how can I help you?"

​
recordingUrl
string
required

Recording URL

Example:

"https://example.com/recording.wav"

​
messages
string[]
required

conversation messages

Example:
[
  {
    "sid": "SM1234567890abcdef",
    "timestamp": "2025-03-17T14:30:00Z",
    "sender": "agent",
    "content": "Hello, how can I assist you today?",
    "mediaUrl": "https://example.com/image.jpg",
    "status": "delivered"
  }
]
​
duration
number
required

Session duration in seconds

Example:

"7200"