One call's current state: whether it's still ringing, when it was answered and ended, and what it was billed.
Request
text
GET https://api.spoofey.com/v1/calls/:id| Path param | Notes |
|---|---|
id |
The id returned by POST /v1/calls. |
Example
bash
curl https://api.spoofey.com/v1/calls/9f2c1a7e-4b3d-4e2a-8f11-2b6a7c9d0e12 \
-H "Authorization: Bearer sk_live_..."Response
json
{
"id": "9f2c1a7e-4b3d-4e2a-8f11-2b6a7c9d0e12",
"status": "completed",
"agent": "15195551234",
"destination": "14165557890",
"caller_id": "18005551234",
"caller_id_name": null,
"rate_per_minute": 0.9,
"billed_seconds": 47,
"billed_credits": 1.155,
"created_at": 1789800000000,
"answered_at": 1789800004000,
"ended_at": 1789800051000
}answered_at / ended_at are null until each happens. A call that never connects still finishes (status: "completed") with its connection fee refunded.
404 if no call with that id belongs to your account.
Errors
Errors come back as {"error":{"message":"...","code":"..."}}. See API errors and rate limits for every status code and the rate limit.