Skip to main content
GET
/
interactions
/
{sid}
Get interaction details
curl --request GET \
  --url https://api.voice-mate.com/v1/interactions/{sid} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "interaction": {
    "sid": "interaction_340846df-6fc5-4550-8c8e-590761765548",
    "agent_sid": "agent_340846df-6fc5-4550-8c8e-590761765548",
    "from_number": "+15893858485",
    "to_number": "+15893858485",
    "direction": "inbound",
    "type": "phone_call",
    "status": "in_progress",
    "started_at": 1746297830472,
    "ended_at": 1746297830472,
    "duration": 100,
    "variables": {
      "customer_name": "John Doe",
      "appointment_time": "2025-06-01T10:00:00Z"
    },
    "recording_url": "https://storage.googleapis.com/my-bucket/recordings/interaction_sid.wav",
    "log": [
      {
        "role": "agent",
        "message": "<string>",
        "timestamp": 123
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer auth header. Pass with value 'Bearer {api_key}'. Api key can be found in account Settings -> API Keys page

Path Parameters

sid
string
required

Interaction identifier

Response

Interaction details

status
enum<string>
required
Available options:
success,
error
interaction
object
required