Calls

Call logs, history, stats, and trends

List calls or get stats/trends

get

Retrieves paginated call logs, aggregated stats, or trends based on action parameter.

• No action: Returns paginated call list

• action=stats: Returns call status breakdown

• action=trends: Returns daily call counts over time

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Alternative: You can also use the x-api-key header instead of Authorization Bearer.

Query parameters

pageinteger · min: 1Optional

Page number for pagination (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

actionstring · enumOptional

Action type (stats or trends)

Possible values:

statusstring · enumOptional

Filter by call status

Possible values:

directionstring · enumOptional

Filter by call direction

Possible values:

phone_number_idstring · uuidOptional

Filter by phone number ID

start_datestring · dateOptional

Filter calls from this date (for trends)

end_datestring · dateOptional

Filter calls until this date (for trends)

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

200

Calls data, stats, or trends

application/json

or

or

401

Unauthorized - Invalid or missing API key

application/json

get

/calls

HTTPcURLJavaScriptPython

GET /v1/calls HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "880e8400-e29b-41d4-a716-446655440003",
      "from_number": "[phone]",
      "to_number": "[phone]",
      "direction": "outbound",
      "status": "completed",
      "duration": 120,
      "cost": 2.4,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 20,
  "total_pages": 8
}

Get call details

get

Retrieves detailed call information including events and recording

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Alternative: You can also use the x-api-key header instead of Authorization Bearer.

Path parameters

idstring · uuidRequired

Call UUID

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

200

Call details

application/json

idstring · uuidOptional

from_numberstringOptionalExample: [phone]

to_numberstringOptionalExample: [phone]

directionstring · enumOptionalPossible values:

statusstring · enumOptionalPossible values:

durationintegerOptional

Call duration in seconds

Example: 120

costnumber · floatOptional

Call cost in cents

Example: 2.4

latency_msintegerOptional

Connection latency in milliseconds

Example: 45

phone_number_idstring · uuidOptional

endpoint_idstring · uuid · nullableOptional

recording_urlstring · uri · nullableOptional

hangup_causestring · nullableOptionalExample: NORMAL_CLEARING

organization_idstring · uuidOptional

created_atstring · date-timeOptional

answered_atstring · date-time · nullableOptional

completed_atstring · date-time · nullableOptional

transcriptstring · nullableOptional

404

Resource not found

application/json

get

/calls/{id}

HTTPcURLJavaScriptPython

GET /v1/calls/{id} HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "880e8400-e29b-41d4-a716-446655440003",
  "from_number": "[phone]",
  "to_number": "[phone]",
  "direction": "outbound",
  "status": "completed",
  "duration": 120,
  "cost": 2.4,
  "latency_ms": 45,
  "hangup_cause": "NORMAL_CLEARING",
  "recording_url": "https://storage.krosai.com/recordings/abc123.mp3",
  "quality_metrics": {
    "mos": 4.2,
    "jitter_ms": 12,
    "packet_loss": 0.01
  },
  "events": [
    {
      "event_type": "call.initiated",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "event_type": "call.ringing",
      "created_at": "2024-01-15T10:30:01Z"
    },
    {
      "event_type": "call.answered",
      "created_at": "2024-01-15T10:30:05Z"
    },
    {
      "event_type": "call.completed",
      "created_at": "2024-01-15T10:32:05Z"
    }
  ],
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:32:05Z"
}

Delete call record

delete

Deletes the call record and associated events

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Alternative: You can also use the x-api-key header instead of Authorization Bearer.

Path parameters

idstring · uuidRequired

Call UUID

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

204

Call deleted

404

Resource not found

application/json

delete

/calls/{id}

HTTPcURLJavaScriptPython

DELETE /v1/calls/{id} HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content