Calls

GET /calls

Finished real calls, newest first. Practice and test calls aren't included.

• since: only calls that started at or after this time, like 2026-11-01T00:00:00Z.
• limit: how many, 1 to 100. The default is 50.

curl "https://www.nerro.co/api/v1/calls?since=2026-11-01T00:00:00Z&limit=20" -H "Authorization: Bearer $KEY"

{
  "data": [
    {
      "id": "c1d2…",
      "direction": "inbound",
      "number": "+13125550142",
      "line": "+13125550100",
      "employee_id": "8f0c…",
      "employee": "Ava",
      "started_at": "2026-11-02T15:04:05.000Z",
      "ended_at": "2026-11-02T15:07:41.000Z",
      "duration_seconds": 216,
      "outcome": "appointment_booked",
      "summary": "Caller booked a showing for 12 Elm St on Thursday at 4 PM.",
      "sentiment": "positive",
      "end_reason": "caller_hung_up",
      "details": { "property": "12 Elm St" }
    }
  ]
}

Fields

• direction: inbound or outbound.
• number: the other person's number. line: your number that took or made the call.
• outcome: appointment_booked, appointment_changed, order_placed, lead_captured, transferred, message_taken, resolved, no_resolution or failed.
• details: what your employee was set up to capture on the call, by field name.

Catching up

To pick up where you left off, keep the newest started_at you've seen and ask again with it as since. A webhook sends each call as it ends, so you don't need to poll.