> ## Documentation Index > Fetch the complete documentation index at: https://docs.rumik.ai/llms.txt > Use this file to discover all available pages before exploring further. # get a call > one call: its status, transcript, a short-lived `recordingUrl` and how it ended. `status` moves `starting` → `running` → `completed` (or `failed` / `expired`). ## OpenAPI ````yaml /openapi.json get /v1/calls/{call_id} openapi: 3.1.0 info: title: silk api version: 1.0.0 description: >- rumik ai's speech api. synthesize speech with the expressive `muga` model, the faster `mulberry` model or the multilingual `mulberry-1.6` model over http or a streaming websocket session, run conversational voice agents over webrtc, a realtime pcm socket or the phone, and manage everything the agents playground does — agents, voices, variables, tools, phone numbers, sip trunks and outbound calls — with the same api key. contact: name: rumik ai url: https://rumik.ai servers: - url: https://silk-api.rumik.ai description: production security: - bearerAuth: [] tags: - name: speech description: text-to-speech over HTTP and WebSocket. - name: voice agents description: start calls with a deployed agent from your own app. - name: agents description: build, configure, deploy and inspect your agents. - name: calls description: place outbound phone calls and read call history. - name: voices description: the voices, languages and styles an agent may use. - name: variables description: account-wide `{name}` prompt variables and their defaults. - name: tools description: HTTP tools agents call before or during a call. - name: phone numbers description: 'numbers rented through rumik: search, rent, connect, release.' - name: sip trunks description: bring your own numbers over SIP. paths: /v1/calls/{call_id}: get: tags: - calls summary: get a call description: >- one call: its status, transcript, a short-lived `recordingUrl` and how it ended. `status` moves `starting` → `running` → `completed` (or `failed` / `expired`). operationId: getCall parameters: - name: call_id in: path required: true schema: type: string format: uuid description: the call's id. responses: '200': description: ok. content: application/json: schema: $ref: '#/components/schemas/Call' examples: default: value: id: 01a05b4d-b1ad-7be0-8d29-04b2fd7e7dca agentSlug: ua_fe3277d8 status: completed channel: phone systemInstruction: >- You are the support agent for {company}. Be brief and warm. When the caller asks for a human, {{transfer_call}}. greeting: Hi, this is {company} support. How can I help? transcript: - role: assistant content: Hi, this is acme support. How can I help? offsetSeconds: 0.4 - role: user content: I need to change my delivery address. offsetSeconds: 3.1 recordingUrl: https://storage.googleapis.com/…?X-Goog-Signature=… startedAt: '2026-09-11T10:20:03Z' endedAt: '2026-09-11T10:21:40Z' durationSeconds: 97 durationMs: 97210 endReason: customer_ended creditsCharged: null creditBalanceAfter: null errorMessage: null summary: null summaryGeneratedAt: null createdAt: '2026-09-11T10:20:00Z' '401': description: >- `unauthorized` — key missing, malformed, unknown, revoked or expired. content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized: value: error: Invalid API key code: unauthorized '403': description: '`forbidden_scope` — the key was created without the `agent` scope.' content: application/json: schema: $ref: '#/components/schemas/Error' examples: forbidden_scope: value: error: This API key lacks the 'agent' scope code: forbidden_scope '404': description: '`agent_run_not_found` — no such call on this account.' content: application/json: schema: $ref: '#/components/schemas/Error' examples: agent_run_not_found: value: error: Conversation not found code: agent_run_not_found '429': description: >- `rate_limited` — the key's per-minute budget is spent. `Retry-After` says how long to wait; the body carries `limit` and `current`. content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limited: value: error: Rate limit exceeded code: rate_limited limit: 100 current: 101 headers: Retry-After: description: seconds to wait before retrying (per-key rate limit only). schema: type: integer components: schemas: Call: properties: id: type: string format: uuid description: the call id — `callId` on the call endpoints. agentSlug: type: string description: >- the agent's handle at the time of the call (`ua_…`), or `draft` / `draft-test` for calls placed from an unsaved draft. status: $ref: '#/components/schemas/AgentRunStatus' description: >- `starting` (bot launching) → `running` → `completed`, or `failed` (never connected / errored) or `expired` (no end signal; never charged). channel: $ref: '#/components/schemas/AgentCallChannel' description: >- how the call reached the agent: `web` (browser, `/v1/webcall`), `phone` (PSTN, in or out) or `realtime` (`/v1/agent/connect`). systemInstruction: type: string description: the persona the call ran with. greeting: type: string description: the greeting the call opened with. transcript: anyOf: - items: $ref: '#/components/schemas/TranscriptMessage' type: array - type: 'null' description: the conversation, in order. present once the call has ended. recordingUrl: anyOf: - type: string - type: 'null' description: >- a signed URL for the recording, valid for a few minutes — fetch it, do not store it. null until the recording lands or when storage is off. startedAt: anyOf: - type: string format: date-time - type: 'null' description: when the caller connected. endedAt: anyOf: - type: string format: date-time - type: 'null' description: when the call ended. durationSeconds: anyOf: - type: integer - type: 'null' description: billed length of the call. durationMs: anyOf: - type: integer - type: 'null' description: the same, in milliseconds. endReason: anyOf: - type: string - type: 'null' description: why it ended, e.g. `customer_ended`, `never_connected`. creditsCharged: anyOf: - type: integer - type: 'null' creditBalanceAfter: anyOf: - type: integer - type: 'null' errorMessage: anyOf: - type: string - type: 'null' description: what went wrong, for a `failed` or `expired` call. summary: anyOf: - type: string - type: 'null' description: an on-demand summary (the dashboard's summary panel), or null. summaryGeneratedAt: anyOf: - type: string format: date-time - type: 'null' createdAt: type: string format: date-time description: when the call was placed. type: object required: - id - agentSlug - status - channel - systemInstruction - greeting - createdAt title: Call description: one call, in any channel, with its transcript and recording. Error: type: object properties: error: type: string description: human-readable error message. code: type: string description: machine-readable error code. AgentRunStatus: type: string enum: - starting - running - completed - failed - expired title: AgentRunStatus description: |- Lifecycle of a billed agent run. ``STARTING`` is written when the session is created and credits are reserved (cap); ``RUNNING`` once the bot reports a successful client connect. Terminal states are ``COMPLETED`` (actual duration billed), ``FAILED`` (never connected / errored) and ``EXPIRED`` (reaped — no end hook within grace; reservation fully refunded). AgentCallChannel: type: string enum: - web - phone - realtime title: AgentCallChannel description: |- How a call reached the agent: a browser (WebRTC) session, an outbound phone (PSTN) call, or the public realtime WebSocket. TranscriptMessage: additionalProperties: true type: object title: TranscriptMessage securitySchemes: bearerAuth: type: http scheme: bearer description: >- your rumik api key, e.g. `rk_live_...`. create one in the rumik dashboard. ````