Skip to main content
The WeCareRemote recordings API provides access to meeting recordings captured during video sessions. Recordings are stored in secure cloud storage and are accessible to authorized users. The API handles the full recording lifecycle — from storage through to expiry and deletion. Common use cases for this API:
  • Building an internal dashboard that lists recent meetings for NGO staff
  • Pulling recordings into a transcription or summarisation pipeline
  • Archiving recordings to long-term storage before they expire
  • Auditing meeting activity for compliance reporting

​
How recordings are stored

When a meeting ends, the recording is automatically uploaded to secure cloud storage. Access, metadata, and retention are managed by the platform. After the configured retention period, recordings are automatically removed.
Recordings are automatically deleted after the retention period expires. Download any important recordings before they are removed — deleted recordings cannot be recovered.

​
Accessing recordings

All recordings endpoints require authentication. Include your Bearer token in the Authorization header on every request. 
Authorization: Bearer your-token
Access to recordings is restricted to users with org_admin permissions. Requests from users without this permission will be rejected with a 403 Forbidden response.

​
Listing recordings

Retrieve a list of all available recordings for your organization. Endpoint: GET /recordings Authentication: Bearer token required — see Authentication.

​
Response

{
  "recordings": [
    {
      "id": "rec_001",
      "meeting_id": "wcr-meeting-xyz",
      "created_at": "2025-01-15T10:30:00Z",
      "duration_seconds": 3600,
      "url": "https://storage.wcr.is/recordings/rec_001.mp4"
    }
  ]
}
​
recordings
array
An array of recording objects.

​
Example

curl https://your-records-backend/recordings \
  -H "Authorization: Bearer your-token"

​
Downloading a recording

Use the url field from the listing response to download a recording. The download URL also requires authentication. 
curl -L "https://storage.wcr.is/recordings/rec_001.mp4" \
  -H "Authorization: Bearer your-token" \
  -o meeting-recording.mp4

import httpx

client = httpx.Client(headers={"Authorization": "Bearer your-token"})

# First, get the list of recordings
recordings = client.get("https://your-records-backend/recordings").json()

# Download the first recording
url = recordings["recordings"][0]["url"]
with client.stream("GET", url) as response:
    with open("recording.mp4", "wb") as f:
        for chunk in response.iter_bytes():
            f.write(chunk)

​
Error responses

Status codeCause
401 UnauthorizedThe Bearer token is missing or invalid.
403 ForbiddenThe token is valid but the user does not have org_admin permissions.
404 Not FoundThe requested recording does not exist or has been deleted.
500 Internal Server ErrorAn unexpected error occurred in the recordings backend.