Developers

NodCall API

A clean, read-only REST API over your call data — build integrations, sync to your CRM, or power your own dashboards.

REST + JSON

Predictable resource URLs

API-key auth

One header, no OAuth dance

Live data

Same source as the panel

Base URL

All developer endpoints live under the versioned /api/v1 prefix.

https://call.edunod.com/api/v1

Authentication

Generate a key in Settings → API Keys (org admins, on eligible plans). It looks like nod_live_… and is shown only once — store it safely. Send it on every request as an x-api-key header (or a Bearer token). Each key is scoped to your workspace, so you only ever see your own data.

# preferred — x-api-key header
curl "https://call.edunod.com/api/v1/ping" \
  -H "x-api-key: nod_live_xxxxxxxxxxxxxxxx"

# also accepted — Authorization: Bearer
curl "https://call.edunod.com/api/v1/ping" \
  -H "Authorization: Bearer nod_live_xxxxxxxxxxxxxxxx"

# response
{ "ok": true, "tenantId": "6a4d35…27d1", "version": "v1" }

Example: fetch a call summary

curl "https://call.edunod.com/api/v1/call-summary?from=2026-07-01&to=2026-07-31" \
  -H "x-api-key: nod_live_xxxxxxxxxxxxxxxx"

{
  "range": { "from": "2026-07-01T00:00:00.000Z", "to": "2026-07-31T23:59:59.999Z" },
  "total": 2922,
  "incoming": 1104,
  "outgoing": 1489,
  "missed": 329,
  "connected": 2129,
  "totalDurationSec": 486210,
  "uniqueClients": 1018,
  "connectRatePct": 73
}

Endpoints

Method	Endpoint	Description
GET	/v1/ping	Verify your API key and see which workspace it belongs to.
GET	/v1/call-summary	Aggregated KPIs for a date range — total, connected, missed, talk time, unique clients, connect rate.
GET	/v1/call-history	Paginated raw call records — number, type, duration, timestamp, whether it has a recording.
GET	/v1/reports/contacted	Clients contacted (≥1 connected call) with call counts & total talk time.
GET	/v1/reports/never-attended	Clients that called or were called but were never attended (no connected call).
GET	/v1/reports/working-hours	Per-employee working-hours summary — calls, talk time, first/last call, active span.

Common query parameters

Parameter	Description
from, to	Date range (ISO or YYYY-MM-DD). Defaults to the last 30 days; max range 366 days.
userId	Optional — scope to a single employee (their NodCall user id).
page, limit	call-history only — pagination (limit 1–500, default 50).

The API is read-only and rate-limited. Keys are managed from your dashboard and can be revoked any time. Questions or need a higher limit? Email hello@edunod.com.