curl --request GET \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId} \
--header 'Authorization: <api-key>'import requests
url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"folder": {
"id": "550e8400-e29b-41d4-a716-446655440001",
"parentFolderId": null,
"name": "Claims Documents",
"category": "Claims"
},
"folders": [
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"parentFolderId": "550e8400-e29b-41d4-a716-446655440001",
"name": "2026 Q1",
"category": null
}
],
"files": [
{
"id": "550e8400-e29b-41d4-a716-446655440020",
"entityType": "company",
"entityId": null,
"displayName": "claim-report.pdf",
"contentType": "application/pdf",
"byteSize": 102400,
"uploadedAt": "2026-06-10T09:15:00.000Z",
"uploadedBy": "550e8400-e29b-41d4-a716-446655440099",
"uploadedByName": "Jane Underwriter",
"folderId": "550e8400-e29b-41d4-a716-446655440001",
"category": null
}
],
"totalCount": 1
}List Folder Contents
Returns what’s inside one folder: the folder node itself, its direct
subfolders (folders, name-ordered, not paginated), and the files
placed in it (files, newest first, paginated with page/pageSize;
totalCount counts the files). Only finalized (ready) files appear.
Required permission: file.view
curl --request GET \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId} \
--header 'Authorization: <api-key>'import requests
url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"folder": {
"id": "550e8400-e29b-41d4-a716-446655440001",
"parentFolderId": null,
"name": "Claims Documents",
"category": "Claims"
},
"folders": [
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"parentFolderId": "550e8400-e29b-41d4-a716-446655440001",
"name": "2026 Q1",
"category": null
}
],
"files": [
{
"id": "550e8400-e29b-41d4-a716-446655440020",
"entityType": "company",
"entityId": null,
"displayName": "claim-report.pdf",
"contentType": "application/pdf",
"byteSize": 102400,
"uploadedAt": "2026-06-10T09:15:00.000Z",
"uploadedBy": "550e8400-e29b-41d4-a716-446655440099",
"uploadedByName": "Jane Underwriter",
"folderId": "550e8400-e29b-41d4-a716-446655440001",
"category": null
}
],
"totalCount": 1
}Authorizations
API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.
Path Parameters
Company identifier
Folder identifier
Query Parameters
Page number (1-based, default 1).
x >= 1Number of records per page (default 50).
x >= 1Response
The folder's contents
One folder node as a flat adjacency-list row — parentFolderId null means
the owner's top level. The folder tree endpoint returns every live folder
for an owner as these rows; consumers assemble the hierarchy client-side.
A folder's category comes from the same per-owner-type vocabulary as a
file's. The files inside carry their own labels independently — a folder's
category never applies to its contents.
Show child attributes
Show child attributes
The folder's direct subfolders
Show child attributes
Show child attributes
The files placed directly in the folder (paginated)
Show child attributes
Show child attributes
Total number of files in the folder across all pages
