curl --request GET \
--url https://{your-subdomain}.neetorecord.com/api/external/v2/folders \
--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/folders', 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/folders"
headers = {
"X-Api-Key": "<x-api-key>",
"Accept": "<accept>"
}
response = requests.get(url, headers=headers)
print(response.text){
"folders": [
{
"id": "hqzptnv",
"name": "Product demos",
"parent_id": null,
"recording_count": 12,
"created_at": "2026-02-02T11:40:18.000Z"
},
{
"id": "wbrkxdm",
"name": "Onboarding",
"parent_id": "hqzptnv",
"recording_count": 3,
"created_at": "2026-02-14T08:12:03.000Z"
}
],
"pagination": {
"total_records": 8,
"total_pages": 1,
"current_page_number": 1,
"page_size": 30
}
}List all folders
Lists every folder in the workspace, with the number of recordings in each.
curl --request GET \
--url https://{your-subdomain}.neetorecord.com/api/external/v2/folders \
--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/folders', 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/folders"
headers = {
"X-Api-Key": "<x-api-key>",
"Accept": "<accept>"
}
response = requests.get(url, headers=headers)
print(response.text){
"folders": [
{
"id": "hqzptnv",
"name": "Product demos",
"parent_id": null,
"recording_count": 12,
"created_at": "2026-02-02T11:40:18.000Z"
},
{
"id": "wbrkxdm",
"name": "Onboarding",
"parent_id": "hqzptnv",
"recording_count": 3,
"created_at": "2026-02-14T08:12:03.000Z"
}
],
"pagination": {
"total_records": 8,
"total_pages": 1,
"current_page_number": 1,
"page_size": 30
}
}{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
API key. Refer to Authentication for more information.
Must be application/json.
application/json Query Parameters
Page of results to retrieve, starting from 1. Defaults to 1 when omitted.
Number of results per page. Defaults to 30 when omitted.
Field to sort by: created_at, name. Defaults to created_at.
created_at, name Sort direction: asc or desc. Defaults to desc.
asc, desc Response
Successfully retrieved folders.
List of folders.
Hide child attributes
Hide child attributes
Unique identifier for the folder.
"hqzptnv"
Name of the folder.
"Product demos"
Identifier of the parent folder, or null for a top level folder.
null
Number of recordings directly inside the folder. Counts only uploaded recordings the caller can see.
12
Timestamp when the folder was created.
"2026-02-02T11:40:18.000Z"