1. REST
CallerAPI Documentation
  • Quickstart
  • Use cases
    • For carriers (MNOs/MVNOs)
    • CPaaS platforms
    • Cloud communications providers
    • SIP trunking providers
    • PBX/Cloud PBX
    • UCaaS vendors
  • Account
    • Balance and email
  • Spam protection
    • Voice firewall
      • Get started
      • Quickstart
        • What you get
        • Before you start
        • Test with a recording
        • Connect your switch
        • Switch notes
        • Twilio and Telnyx
        • Send text instead of audio
      • Verdicts
        • Read a verdict
        • What to do with a verdict
        • Block a caller
        • Events and webhooks
      • Honeypot
        • Hand a call over
        • Audio, events, and limits
      • Reference
        • Endpoints
        • Errors
        • Limits and thresholds
        • Production checklist
      • REST
        • What this deployment can do
          GET
        • List the verdict categories
          GET
        • List the honeypot personas
          GET
        • Score a transcript or a recording
          POST
        • List your recent sessions
          GET
        • Get one session with verdict and intel
          GET
        • Twilio voice URL for a screened number
          POST
        • Preview the Twilio TwiML
          GET
        • Telnyx voice URL for a screened number
          POST
        • Twilio voice URL for a honeypot number
          POST
        • Telnyx voice URL for a honeypot number
          POST
      • WebSocket
        • Live scam filter stream
        • Honeypot stream
    • Daily spam reports
      • Webhook
        • Subscribe to daily reports
        • Unsubscribe from daily reports
        • List webhook subscriptions
        • Manual dispatch of reports
        • Test webhook
      • REST
        • Fetch daily spam reports
    • 15 days spam CSV snapshot
      GET
    • Spam score + HLR
      GET
  • Mobile SDK
    • Get started
    • Quickstart
      • What you get
      • Get your keys
      • Android
      • iOS
      • Flutter
      • React Native
      • Check it works
    • Call screening
      • What each platform can do
      • Android call screening
      • iOS prerequisites
      • iOS add the extension
      • iOS test on device
    • Reference
      • Methods
      • Errors
      • Limits and billing
      • Troubleshooting
  • Data partners
    • Partner tems & docs
    • Upload spam reports
    • Upload contacts
  • Fraud prevention
    • Ported date
    • Porting history
    • Online presence
    • KYC user identity
  • Schemas
    • Spam protection
      • Spam score request
      • Business info
      • Carrier info
      • Complaint (without number)
      • Daily spam reports request
      • Complaint (with phone)
  1. REST

Get one session with verdict and intel

GET
/api/voice/sessions/{id}
The session record plus verdict and intel as objects. Use it to recover a missed webhook post or to answer a dispute. Free.

Request

Authorization
API Key
Add parameter in header
x-auth
Example:
x-auth: ********************
or
Path Params

Responses

🟢200The session
application/json
The session.
Bodyapplication/json

🟠401Missing or wrong API key
🟠404Session not found, or it belongs to another key
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.callerapi.com/api/voice/sessions/7463336c-c965-450f-b188-e6908e969395' \
--header 'x-auth: <api-key>'
Response Response Example
200 - Example 1
{
    "status": "success",
    "session": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "kind": "filter",
        "protocol": "raw",
        "call_id": "string",
        "from": "string",
        "to": "string",
        "persona_id": "string",
        "started_at": "2019-08-24T14:15:22.123Z",
        "ended_at": "2019-08-24T14:15:22.123Z",
        "duration_seconds": 0,
        "turns": 0,
        "transcript": "string",
        "score": 0,
        "level": "clean",
        "category": "string",
        "summary": "string",
        "intel_count": 0,
        "reported": true
    },
    "verdict": {
        "score": 0,
        "level": "clean",
        "category": "string",
        "tactics": [
            "urgency"
        ],
        "signals": [
            "string"
        ],
        "summary": "string",
        "source": "heuristic"
    },
    "intel": {
        "names": [
            "string"
        ],
        "organizations": [
            "string"
        ],
        "callback_numbers": [
            "string"
        ],
        "emails": [
            "string"
        ],
        "urls": [
            "string"
        ],
        "crypto_wallets": [
            "string"
        ],
        "bank_accounts": [
            "string"
        ],
        "card_numbers": [
            "string"
        ],
        "gift_card_brands": [
            "string"
        ],
        "payment_apps": [
            "string"
        ],
        "remote_tools": [
            "string"
        ],
        "remote_codes": [
            "string"
        ],
        "case_numbers": [
            "string"
        ],
        "amounts": [
            "string"
        ],
        "addresses": [
            "string"
        ],
        "scripts": [
            "string"
        ],
        "dtmf": "string"
    }
}
Modified at 2026-09-18 16:51:49
Previous
List your recent sessions
Next
Twilio voice URL for a screened number
Built with