List Files

curl --request GET \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/files \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/files', 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}/files",
  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}/files"

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

}

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/files")

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

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440020",
      "entityType": "company",
      "entityId": null,
      "placementId": "550e8400-e29b-41d4-a716-446655440030",
      "placementCount": 1,
      "displayName": "master-agreement.pdf",
      "contentType": "application/pdf",
      "byteSize": 482133,
      "uploadedAt": "2026-06-10T09:15:00.000Z",
      "uploadedBy": "550e8400-e29b-41d4-a716-446655440099",
      "uploadedByName": "Jane Underwriter",
      "folderId": null,
      "category": null
    }
  ],
  "totalCount": 1
}

Files

List Files

Returns the files visible to an owner (a configured entity or the company level), newest first by the file’s display date (displayDate when set, else its creation time — so backdated historical files interleave correctly). Only finalized (ready) files are listed — pending uploads are never returned.

Optionally filter by folder placement with folderId: omit it for every folder, pass a folder id for that folder’s files, or pass an empty value (folderId=) for the owner’s top level only.

Required permission: company.file:read

GET

api

companies

{companyId}

files

List Files

curl --request GET \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/files \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/files', 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}/files",
  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}/files"

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

}

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/files")

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

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440020",
      "entityType": "company",
      "entityId": null,
      "placementId": "550e8400-e29b-41d4-a716-446655440030",
      "placementCount": 1,
      "displayName": "master-agreement.pdf",
      "contentType": "application/pdf",
      "byteSize": 482133,
      "uploadedAt": "2026-06-10T09:15:00.000Z",
      "uploadedBy": "550e8400-e29b-41d4-a716-446655440099",
      "uploadedByName": "Jane Underwriter",
      "folderId": null,
      "category": null
    }
  ],
  "totalCount": 1
}

Authorizations

Authorization

string

header

required

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

companyId

string<uuid>

required

Company identifier

Query Parameters

entityType

enum<string>

required

The file owner's entity type — a configured Field Model V1 entity type (lowercase kebab-case URL slug, e.g. event, exposure, policy), or company for company-level files and folders. PascalCase (Event) is rejected with a 400 — matching the /entities/{type} path convention.

Available options:

event,

exposure,

quote,

submission,

person,

organization,

policy,

company

entityId

string<uuid>

The owner entity's id. Required for every entityType except company (company-level files and folders have no entity id — omit this parameter).

folderId

string

Folder placement filter — omit for every folder, a folder id for that folder, or empty (folderId=) for the owner's top level.

page

integer

default:1

Page number (1-based, default 1).

Required range: x >= 1

pageSize

integer

default:50

Number of records per page (default 50).

Required range: x >= 1

Response

Paginated list of files

items

object[]

Show child attributes

totalCount

integer

Total number of matching files across all pages

⌘I

Getting Started

User

Entities

Event Lifecycle

Policy Transactions

Financials

Rating

Notes

Tasks

Configuration Management

Company Files

Forms

Document Generation

Submission Parsing

Reference

List Files

Authorizations

Path Parameters

Query Parameters

Response