Skip to main content
GET
/
recordings
List all recordings
curl --request GET \
  --url https://{your-subdomain}.neetorecord.com/api/external/v2/recordings \
  --header 'Accept: <accept>' \
  --header 'X-Api-Key: <x-api-key>'
{
  "recordings": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Product demo walkthrough",
      "default_title": "Recording 2026-02-15",
      "duration": 125.5,
      "view_count": 42,
      "is_uploaded": true,
      "requested": false,
      "summary": "Overview of the main features and how to get started with the product.",
      "public_link_id": "x9y8z7w6v5u4t3s2",
      "created_at": "2026-02-15T10:30:00.000Z",
      "updated_at": "2026-02-15T11:45:00.000Z",
      "uploaded_at": "2026-02-15T10:35:00.000Z",
      "public_url": "https://your-workspace.neetorecord.com/watch/x9y8z7w6v5u4t3s2",
      "transcoded_url": "https://cdn.neetorecord.com/recordings/a1b2c3d4/transcoded.m3u8?signature=...",
      "thumbnail_url": "https://cdn.example.com/thumbnails/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg?v=1",
      "user_name": "Jane Smith",
      "tags": [
        {
          "id": "tag-001",
          "name": "Demo",
          "style": "blue"
        }
      ],
      "folder_name": "Sales",
      "folder_id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "title": "Sprint planning meeting",
      "default_title": "Recording 2026-02-14",
      "duration": 1842,
      "view_count": 5,
      "is_uploaded": true,
      "requested": true,
      "summary": "Transcript too brief to summarize meaningfully.",
      "public_link_id": "a1b2c3d4e5f6g7h8",
      "created_at": "2026-02-14T09:00:00.000Z",
      "updated_at": "2026-02-14T09:52:00.000Z",
      "uploaded_at": "2026-02-14T09:15:00.000Z",
      "public_url": "https://your-workspace.neetorecord.com/watch/a1b2c3d4e5f6g7h8",
      "transcoded_url": null,
      "thumbnail_url": "https://cdn.example.com/thumbnails/b2c3d4e5-f6a7-8901-bcde-f23456789012.jpg?v=1",
      "user_name": "John Doe",
      "tags": [],
      "folder_name": null,
      "folder_id": null
    }
  ],
  "pagination": {
    "total_records": 150,
    "total_pages": 5,
    "current_page_number": 1,
    "page_size": 30
  }
}
Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Identifying subdomain.

Headers

X-Api-Key
string
required

API key. Refer to Authentication for more information.

Accept
enum<string>
default:application/json
required

Must be application/json.

Available options:
application/json

Query Parameters

page_number
integer

Page number. If absent, all results are returned.

page_size
integer

Number of results per page. Defaults to 30.

Response

200 - application/json

Successfully retrieved recordings.

recordings
object[]

List of recordings.

pagination
object