Skip to main content
GET
/
recordings
List all recordings
curl --request GET \
  --url https://{your-subdomain}.neetorecord.com/api/external/v1/recordings \
  --header 'Accept: <accept>' \
  --header 'X-Api-Key: <x-api-key>'
{
  "recordings": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Product demo walkthrough",
      "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",
      "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",
      "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",
      "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 your subdomain.

Headers

​
X-Api-Key
string
required

X-Api-Key is used to authenticate requests using an API key. Provide your API key in this header to access protected endpoints. Refer to Authentication for more information.

​
Accept
enum<string>
default:application/json
required

Specifies the expected response format. Must be set to application/json for proper API communication.

Available options:
application/json

Query Parameters

​
page_number
integer

Retrieve paginated results by specifying the desired page number. If this parameter is absent, all results will be returned.

​
page_size
integer

Set the number of results returned in the response. Defaulting to 30 when omitted.

Response

200 - application/json

Successfully retrieved recordings.

​
recordings
object[]

List of recordings.

​
pagination
object