List 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>'

const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>', Accept: '<accept>'}};

fetch('https://{your-subdomain}.neetorecord.com/api/external/v2/recordings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetorecord.com/api/external/v2/recordings"

headers = {
    "X-Api-Key": "<x-api-key>",
    "Accept": "<accept>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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",
      "has_transcript": true
    },
    {
      "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,
      "has_transcript": false
    }
  ],
  "pagination": {
    "total_records": 150,
    "total_pages": 5,
    "current_page_number": 1,
    "page_size": 30
  }
}

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>'

const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>', Accept: '<accept>'}};

fetch('https://{your-subdomain}.neetorecord.com/api/external/v2/recordings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetorecord.com/api/external/v2/recordings"

headers = {
    "X-Api-Key": "<x-api-key>",
    "Accept": "<accept>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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",
      "has_transcript": true
    },
    {
      "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,
      "has_transcript": false
    }
  ],
  "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 Workspace subdomain.

Headers

X-Api-Key

string

required

API key. Refer to Authentication for more information.

enum<string>

default:application/json

required

Must be application/json.

Available options:

application/json

Query Parameters

page_number

integer

Page of results to retrieve, starting from 1. Defaults to 1 when omitted.

page_size

integer

Number of results per page. Defaults to 30 when omitted.

owner_email

string

Only recordings owned by the member with this email address. Send me for the signed-in member, which works only with a CLI session. An unknown email returns an empty list.

from_date

string

Only recordings created on or after this date, in YYYY-MM-DD or YYYY-MM format, evaluated in UTC.

to_date

string

Only recordings created on or before this date, in YYYY-MM-DD or YYYY-MM format, evaluated in UTC.

folder_id

string

Only recordings in this folder. Accepts the folder id from the folders API.

tag_names[]

string[]

Only recordings carrying at least one of these tags. Repeat the parameter for each tag.

title

string

Only recordings whose title or default title contains this text.

has_transcript

boolean

true for only recordings with a transcript, false for only recordings without one.

requested_only

boolean

default:false

List only recordings created from a recording request.

sort_by

enum<string>

default:created_at

Field to sort by: created_at, title, duration, view_count. Defaults to created_at.

Available options:

created_at,

title,

duration,

view_count

sort_direction

enum<string>

default:desc

Sort direction: asc or desc. Defaults to desc.

Available options:

asc,

desc

Response

Successfully retrieved recordings.

recordings

object[]

List of recordings.

Hide child attributes

recordings.id

string

Unique identifier for the recording.

recordings.title

string | null

Custom title set by the user.

recordings.default_title

string

Auto-generated title for the recording.

recordings.duration

number | null

Duration of the recording in seconds.

recordings.view_count

integer

Number of times the recording has been viewed.

recordings.is_uploaded

boolean

Whether the recording has been fully uploaded.

recordings.requested

boolean

Whether the recording was requested from someone.

recordings.summary

string | null

AI-generated summary of the recording.

recordings.public_link_id

string | null

Public link identifier used in the watch URL.

recordings.public_url

string | null

Public watch URL for the recording.

recordings.transcoded_url

string | null

CloudFront signed URL for the transcoded video.

recordings.thumbnail_url

string | null

URL for the recording thumbnail image.

recordings.user_name

string

Display name of the user who created the recording.

recordings.tags

object[]

Tags associated with the recording.

Hide child attributes

recordings.tags.id

string

Unique identifier for the tag.

recordings.tags.name

string

Name of the tag.

recordings.tags.style

string

Style/color of the tag.

recordings.folder_name

string | null

Name of the folder containing the recording.

recordings.folder_id

string | null

Unique identifier of the folder containing the recording.

recordings.has_transcript

boolean

Whether the recording has transcript text.

recordings.created_at

string<date-time>

Timestamp when the recording was created.

recordings.updated_at

string<date-time>

Timestamp when the recording was last updated.

recordings.uploaded_at

string<date-time> | null

Timestamp when the recording was uploaded.

pagination

object

Hide child attributes

pagination.total_records

integer

Total number of records.

Example:

95

pagination.total_pages

integer

Total number of pages available.

Example:

4

pagination.current_page_number

integer

Current page number.

Example:

1

pagination.page_size

integer

Number of records per page.

Example:

30

Getting started

Recordings

Folders

Tags

Recording requests

Analytics

Team members

API v1 (deprecated)

Headers

Query Parameters

Response