Download Form

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

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/forms/{number}"

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}/forms/{number}', 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}/forms/{number}",
  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}/forms/{number}"

	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}/forms/{number}")

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

{
  "downloadUrl": "https://storage.googleapis.com/bucket/acme/.../formTemplates/.../V-001/....docx?X-Goog-Expires=900&X-Goog-Signature=...",
  "fileName": "Certificate of Insurance.docx",
  "contentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "expiresAt": "2026-07-02T09:30:00.000Z"
}

Forms

Download Form

Returns a short-lived signed URL to download a form’s current version original uploaded file, addressed by its stable FM-XXXX number. Works for both DOCX templates and static PDF forms — the file you get back is the DOCX (templates) or PDF (static forms) exactly as it was uploaded.

Fetch the bytes with a plain GET of downloadUrl — they come straight from cloud storage, never through this API. The URL is signed with an attachment; filename="<fileName>" content disposition and expires at expiresAt (15 minutes); request a fresh one instead of caching it.

Pair this with List Forms to discover a form’s number.

Required permission: forms:read

GET

api

companies

{companyId}

forms

{number}

Download Form

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

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/forms/{number}"

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}/forms/{number}', 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}/forms/{number}",
  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}/forms/{number}"

	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}/forms/{number}")

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

{
  "downloadUrl": "https://storage.googleapis.com/bucket/acme/.../formTemplates/.../V-001/....docx?X-Goog-Expires=900&X-Goog-Signature=...",
  "fileName": "Certificate of Insurance.docx",
  "contentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "expiresAt": "2026-07-02T09:30:00.000Z"
}

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

number

string

required

The form template's stable FM-XXXX number (as returned by the Upload Form Template endpoint). It identifies the template across all of its versions and is the same value forms-logic rules reference.

Response

Signed download URL for the form's current-version file

A short-lived signed URL to download a form's current-version file, plus the metadata a caller needs to save it.

downloadUrl

string

required

Short-lived signed URL to GET the file bytes from cloud storage directly (they never pass through this API).

fileName

string

required

The download filename (also signed into the URL's attachment content disposition), e.g. Certificate of Insurance.docx.

contentType

string

required

MIME type of the file — the DOCX Office type for templates, application/pdf for static forms.

expiresAt

string<date-time>

required

ISO instant the URL stops working (15 minutes out). Request a fresh one instead of caching it.

⌘I

Getting Started

User

Entities

Event Lifecycle

Policy Transactions

Financials

Rating

Notes

Tasks

Configuration Management

Company Files

Forms

Document Generation

Submission Parsing

Reference

Download Form

Authorizations

Path Parameters

Response