API reference

GET /v1/calls/:id · Get a call

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.

Was this helpful?Your answer helps us improve this page.
Still stuck?Ask Spoofey AI about your exact case, or a person on our team will reply by email.
Last modified on September 25, 2026 · 1 min read
Edit