---
title: "Get a session recording"
method: GET
path: "/phones/sessions/{session_id}/recording"
tags: ["Phones"]
---

# Get a session recording

`GET /phones/sessions/{session_id}/recording`

Returns a short-lived URL for the session's screen recording, keyed on session_id — so it works for workflow runs and workflow-less interactive leases alike. Status is "pending" (no URL) when the recording hasn't finished uploading yet. Org-scoped: another org's session reads as not found.

## Path parameters

- `session_id` string, uuid, required — Phone session identifier

## Response `200`

OK

- PhoneSessionRecordingResponse — Session recording lookup result.
  - `status` 'ready' | 'pending' | 'expired', required — 'ready' when a recording URL is returned, 'pending' while the recording is still being processed, or 'expired' when it is past the plan's recording retention window.
  - `url` string — Playback URL for the recording MP4, set only when status is 'ready'. The URL is time-limited.

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/revisions/261c340a3f6d/schema)