List Parse Runs

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

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/parse-runs"

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}/files/parse-runs', 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/parse-runs",
  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/parse-runs"

	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/parse-runs")

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": [
    {
      "runId": "0f204eac-17e5-42bc-93b1-0dd2aea57baa",
      "flow": "submission",
      "target": {
        "kind": "folder",
        "id": "3c93ad46-9d7c-4f5a-b4de-9f0f9a4f6a2e"
      },
      "parseTaskName": "create_submission_v1",
      "status": "succeeded",
      "attempts": 1,
      "createdAt": "2026-06-30T12:01:30.000Z",
      "finishedAt": "2026-06-30T12:03:05.000Z",
      "stages": {
        "extract": {
          "status": "succeeded",
          "attempts": 1,
          "finishedAt": "2026-06-30T12:02:10.000Z"
        },
        "parse": {
          "status": "succeeded",
          "attempts": 1,
          "finishedAt": "2026-06-30T12:03:05.000Z"
        }
      },
      "createdEntities": [
        {
          "entityType": "submission",
          "entityId": "2b8dc3a1-51de-4f92-a3a0-1f5ba3a9a111",
          "deleted": false
        },
        {
          "entityType": "quote",
          "entityId": "61b3c2d4-7a90-4a1c-8321-9adf5f2f2222",
          "deleted": false
        }
      ],
      "extractionReady": true,
      "rerunOfRunId": null,
      "reusedExtractOfRunId": null
    },
    {
      "runId": "994bfc11-8ff3-485a-89ff-7839c9bb6101",
      "flow": null,
      "target": null,
      "parseTaskName": "extract",
      "status": "succeeded",
      "attempts": 1,
      "createdAt": "2026-06-30T11:01:10.000Z",
      "finishedAt": "2026-06-30T11:01:25.000Z",
      "legacy": true
    }
  ],
  "totalCount": 2
}

Submission Parsing

List Parse Runs

List a company’s parse runs, newest-first and paginated. Use this to poll the outcome of a parse you kicked with Trigger Parse.

A run record is one logical parse run — the extract stage and the create_<flow>_v<N> parse stage of a single trigger, reported together:

runId is the logical run’s stable id.
flow is the flow the run implements (submission or policy).
target is the { kind, id } file or folder the run parsed.
status is the overall run status, collapsed to one of running, succeeded, or failed (every internal failed_* retry state reads as failed; a run that will still be retried reports failed here — check stages for retrying detail. A run holding for a precondition reads as running, because it has not failed).
stages breaks the run into its extract and parse stages, each with its own status (including the distinct retrying, the not-yet-started pending, and waiting — holding for a precondition, not a failure), attempts, optional error, and finishedAt.
createdEntities lists the entities the run created (entityType + entityId); an entity deleted after the run reports deleted: true.
extractionReady says whether the run’s merged extraction artifact was persisted.
error is present only on a run that recorded a failure message.

Runs that predate run grouping are reported as legacy records (legacy: true): one record per pipeline task, target: null, no stages/createdEntities.

Pagination uses the standard 1-based page / pageSize query params.

Required permission: company.file:read

GET

api

companies

{companyId}

files

parse-runs

List Parse Runs

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

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/parse-runs"

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}/files/parse-runs', 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/parse-runs",
  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/parse-runs"

	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/parse-runs")

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": [
    {
      "runId": "0f204eac-17e5-42bc-93b1-0dd2aea57baa",
      "flow": "submission",
      "target": {
        "kind": "folder",
        "id": "3c93ad46-9d7c-4f5a-b4de-9f0f9a4f6a2e"
      },
      "parseTaskName": "create_submission_v1",
      "status": "succeeded",
      "attempts": 1,
      "createdAt": "2026-06-30T12:01:30.000Z",
      "finishedAt": "2026-06-30T12:03:05.000Z",
      "stages": {
        "extract": {
          "status": "succeeded",
          "attempts": 1,
          "finishedAt": "2026-06-30T12:02:10.000Z"
        },
        "parse": {
          "status": "succeeded",
          "attempts": 1,
          "finishedAt": "2026-06-30T12:03:05.000Z"
        }
      },
      "createdEntities": [
        {
          "entityType": "submission",
          "entityId": "2b8dc3a1-51de-4f92-a3a0-1f5ba3a9a111",
          "deleted": false
        },
        {
          "entityType": "quote",
          "entityId": "61b3c2d4-7a90-4a1c-8321-9adf5f2f2222",
          "deleted": false
        }
      ],
      "extractionReady": true,
      "rerunOfRunId": null,
      "reusedExtractOfRunId": null
    },
    {
      "runId": "994bfc11-8ff3-485a-89ff-7839c9bb6101",
      "flow": null,
      "target": null,
      "parseTaskName": "extract",
      "status": "succeeded",
      "attempts": 1,
      "createdAt": "2026-06-30T11:01:10.000Z",
      "finishedAt": "2026-06-30T11:01:25.000Z",
      "legacy": true
    }
  ],
  "totalCount": 2
}

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

page

integer

1-based page number. Defaults to the first page.

Required range: x >= 1

pageSize

integer

Number of runs per page. Defaults to the API page size.

Required range: x >= 1

Response

A page of parse runs, newest-first

items

object[]

Show child attributes

totalCount

integer

Total number of parse runs for the company, ignoring pagination.

⌘I

Getting Started

User

Entities

Event Lifecycle

Policy Transactions

Financials

Rating

Notes

Tasks

Configuration Management

Company Files

Forms

Document Generation

Submission Parsing

Reference

List Parse Runs

Authorizations

Path Parameters

Query Parameters

Response