List Aura voice-agent calls

GET

/api/v2/aura/calls

curl --request GET \
  --url 'https://api.sipstack.com/api/v2/aura/calls?page=1&limit=50' \
  --header 'x-api-key: <x-api-key>'

import requests

url = "https://api.sipstack.com/api/v2/aura/calls"

querystring = {"page":"1","limit":"50"}

headers = {"x-api-key": "<x-api-key>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

const url = 'https://api.sipstack.com/api/v2/aura/calls?page=1&limit=50';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.sipstack.com/api/v2/aura/calls',
  params: {page: '1', limit: '50'},
  headers: {'x-api-key': '<x-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Returns your organization’s AI voice-agent calls, newest first, with filtering. Each item carries the post-call outcome, sentiment, and summary. Requires the aura:read scope.

Authorizations

apiKeyAuth

Parameters

Query Parameters

page

integer

default: 1 >= 1

limit

integer

default: 50 >= 1 <= 200

agent_id

string format: uuid

Filter to a single voice agent (UUID).

outcome

string

Filter by terminal outcome (e.g. resolved, transferred).

from_date

string format: date-time

to_date

string format: date-time

Responses

200

Paginated agent-call list.

application/json

object

success

boolean

data

Array<object>

An Aura AI voice-agent call (list view).

object

string format: uuid

call_id

string

agent_id

string

nullable

agent_name

string

nullable

direction

string

Allowed values: inbound outbound

src

string

dst

string

call_date

string format: date-time

billsec

integer

outcome

Terminal outcome of the agent call (e.g. resolved, transferred).

string

nullable

sentiment

string

nullable

summary

Post-call AI summary.

string

nullable

created_at

string format: date-time

pagination

Page metadata returned by the paginated Developer API list endpoints. Per-endpoint limit defaults and caps vary (see each endpoint’s limit parameter). In keyset (cursor) mode page, total, and totalPages are null — walk pages via next_cursor instead.

object

page

integer

nullable

limit

Items per page (the default and maximum vary by endpoint).

integer

total

Total matching records across all pages (null in cursor mode).

integer

nullable

totalPages

integer

nullable

Examples

page

First page of agent calls

{
  "success": true,
  "data": [
    {
      "id": "c4a2e6d8-1b3f-4c5a-8e7d-9f0a1b2c3d4e",
      "call_id": "1765432200.5190",
      "agent_id": "d5b3f7e9-2c4a-4d6b-9f8e-0a1b2c3d4e5f",
      "agent_name": "Support Agent",
      "direction": "inbound",
      "src": "+14165550100",
      "dst": "+16473001234",
      "call_date": "2026-01-15T16:05:00.000Z",
      "billsec": 128,
      "outcome": "resolved",
      "sentiment": "positive",
      "summary": "Caller asked about a charge on their latest invoice; agent explained the proration and confirmed no action was needed.",
      "created_at": "2026-01-15T16:07:08.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 24,
    "totalPages": 1
  }
}

400

Invalid agent_id or date filter.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}

401

Missing or invalid API key.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}

403

The key is missing the aura:read scope.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}