Skip to main content
GET
https://app.medisync.me
/
api
/
recordings
List All Recordings
curl --request GET \
  --url https://app.medisync.me/api/recordings \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "data": [
    {
      "_id": "<string>",
      "appointment_id": "<string>",
      "recording_url": "<string>",
      "recording_key": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "error": "<string>"
}

​
Overview

Retrieves a list of all recordings in the system. This endpoint returns an array of all recording objects without any filtering.
This endpoint returns all recordings in the system. Consider using pagination or filtering in your application if dealing with a large number of recordings.

​
Authentication

​
Authorization
string
required
Bearer JWT token for authentication
Authorization: Bearer your_jwt_token_here

​
Response

​
success
boolean
required
Indicates if the request was successful
​
data
array
Array of all recording objects in the system
​
error
string
Error message if the request failed

​
Example Request

curl -X GET \
  'https://app.medisync.me/api/recordings' \
  -H 'Authorization: Bearer your_jwt_token_here'

​
Example Response

Success Response - With Recordings
{
  "success": true,
  "data": [
    {
      "_id": "65f8a1b2c3d4e5f6789012f4",
      "appointment_id": "65f8a1b2c3d4e5f6789012f3",
      "recording_url": "https://storage.example.com/recordings/65f8a1b2c3d4e5f6789012f3_recording.wav",
      "recording_key": "65f8a1b2c3d4e5f6789012f3_recording.wav",
      "createdAt": "2024-03-18T10:30:00.000Z",
      "updatedAt": "2024-03-18T10:30:00.000Z"
    },
    {
      "_id": "65f8a1b2c3d4e5f6789012f5",
      "appointment_id": "65f8a1b2c3d4e5f6789012f6",
      "recording_url": "https://storage.example.com/recordings/65f8a1b2c3d4e5f6789012f6_recording.wav",
      "recording_key": "65f8a1b2c3d4e5f6789012f6_recording.wav",
      "createdAt": "2024-03-18T11:15:00.000Z",
      "updatedAt": "2024-03-18T11:15:00.000Z"
    }
  ]
}
Success Response - No Recordings
{
  "success": true,
  "data": []
}
Error Response
{
  "success": false,
  "error": "Database error message"
}

​
Behavior Notes

  • All Recordings: Returns all recordings in the system without filtering
  • Array Response: Always returns an array, even if no recordings exist (empty array)
  • No Pagination: This endpoint does not implement pagination
  • Authentication Required: Requires valid JWT token for access

​
Use Cases

  1. System Overview: Get a complete list of all recordings in the system
  2. Administrative Management: View all recordings for system administration
  3. Data Export: Retrieve all recording metadata for export or backup
  4. Monitoring: Monitor the total number and status of recordings