Skip to main content
calls on a team or project client reads call history. callRetention sets how long Polymorfa keeps call data. A team client covers every project unless you pass projectId. A project client reads only its own project.

Read call statistics

groupBy is day (the default), hour, session, or outcome. Without since and until, the range is the last 7 days. timezone is an IANA zone name and defaults to UTC. Every call method accepts the same filters: sessionId, direction (inbound or outbound), upstream (linked_device or cloud_api), outcome (answered, missed, declined, failed, or in_progress), and since and until as RFC 3339 timestamps or Date objects.

List call records

Records are newest first. They never contain phone numbers. peerRef is a pseudonym for the other party that stays the same across your team’s calls. Read one call’s full detail, including its event history and media measurements:

Export call records

exportAll returns every page as text, in order. CSV pages after the first leave out the header row, so you can write the chunks to one file:
Pass format: "ndjson" for one JSON record per line. export returns a single page of up to 1,000 records with a nextCursor.

Set call data retention

Retention is one setting for the whole team. Changing it needs a team key.
A stale expectedRevision fails with 409 state_conflict. Without it, the update applies regardless of other changes.
Deletion of call data older than the retention period starts on a date Polymorfa announces in the changelog. Until then, the setting records your choice and nothing is deleted. After deletion starts, a shorter period also removes call data already stored, and deleted data cannot be recovered.
See Call data retention.