Read one bounded factual post-call result group

Reads a customer-owned external_group_reference inside the authenticated organization/project. This is a pure, provider-free reconciliation read: it does not create calls, retry recipients, classify a business outcome, or copy recordings/transcripts. It returns authoritative technical call facts and a versioned, allowlisted technical_failure envelope separately from optional advisory extraction, plus authenticated evidence anchors (turn identifiers and offsets only). Historical failures without versioned evidence remain unknown and are never inferred from duration. The answered_or_voicemail metric deliberately includes only observable SIP/media answer evidence and may include voicemail; human_answered remains not_provable until a separately validated signal exists. Treat pagination as mandatory: a page is not the whole group while pagination.has_more is true.

get/v1/call-results

Request

  • Base URL: https://api.skysay.ai
  • URL: https://api.skysay.ai/v1/call-results
  • Auth: HTTP bearer

Query parameters

organization_idstring required

The authenticated organization; must match the bearer workspace.

project_idstring required

Project inside the authenticated organization.

external_group_referencestring required

Opaque customer-owned group key. Skysay does not assign campaign, debt, or retry semantics to it.

terminal_status'all' | 'terminal' | 'non_terminal'
artifact_readiness'all' | 'ready' | 'not_ready'

ready requires both an available recording and at least one transcript turn.

extraction_state'all' | 'not_configured' | 'pending' | 'ready' | 'failed'
platform_exception'all' | 'only' | 'none'

Filters only generic platform-quality facts, never customer business classifications.

beforestring

Opaque page_cursor from the previous response; continue with the returned next_cursor.

limitinteger

Response

Bounded factual call result page. Server-Timing and X-Skysay-Query-Count describe the fixed read budget; Cache-Control is no-store.

external_group_referencestring required
filtersobject required
versioninteger required

Changes

No recorded changes to this operation across all 1 revision of this API.