Uploading Status

cURL

curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/policies/uploads/{uploadId}

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v1/policies/uploads/{uploadId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "uploadId": "6650a1b2c3d4e5f6a7b8c9d0",
  "status": "COMPLETED",
  "totalRows": 1000,
  "created": 851,
  "updated": 149,
  "failed": 0,
  "errors": [
    {
      "index": 47,
      "error": "Missing required field: riskStateCode",
      "policyNumber": "POL-2025-001"
    }
  ],
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:31:45.000Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

GET

policies

uploads

{uploadId}

cURL

curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/policies/uploads/{uploadId}

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v1/policies/uploads/{uploadId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "uploadId": "6650a1b2c3d4e5f6a7b8c9d0",
  "status": "COMPLETED",
  "totalRows": 1000,
  "created": 851,
  "updated": 149,
  "failed": 0,
  "errors": [
    {
      "index": 47,
      "error": "Missing required field: riskStateCode",
      "policyNumber": "POL-2025-001"
    }
  ],
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:31:45.000Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

Poll this endpoint to track the progress of a file upload initiated via Upload Policy File. Returns the current processing status, record counts, and any errors encountered during ingestion.

Polling Strategy

Recommended interval: Poll every 3-5 seconds while status is QUEUED or PROCESSING. Stop polling once the status reaches a terminal state (COMPLETED, COMPLETED_WITH_FAILURES, FAILED, or CANCELLED) or a paused state (NEEDS_CLARIFICATION).

QUEUED

Upload received, waiting for a worker to pick it up.

PROCESSING

Worker is actively parsing the file and creating policies and transactions.

Terminal state reached

Processing ends with one of: COMPLETED, COMPLETED_WITH_FAILURES, FAILED, or CANCELLED. The status NEEDS_CLARIFICATION means processing is paused awaiting user input. Stop polling and inspect the response.

Status Values

Status	Terminal?	Description
`QUEUED`	No	Upload received, waiting for a worker to pick it up
`PROCESSING`	No	Worker is actively parsing the file and creating policies/transactions
`COMPLETED`	Yes	All rows processed successfully
`COMPLETED_WITH_FAILURES`	Yes	Processing finished but some rows failed — check `errors` array
`NEEDS_CLARIFICATION`	No	Processing paused — AI matching requires user input to continue
`FAILED`	Yes	Processing failed entirely
`CANCELLED`	Yes	Processing was cancelled

Response Shape

All successful responses are wrapped in the standard response envelope. See Request/Response Conventions.

{
  "statusCode": 200,
  "data": {
    "uploadId": "6650a1b2c3d4e5f6a7b8c9d0",
    "status": "COMPLETED",
    "totalRows": 1000,
    "created": 851,
    "updated": 149,
    "failed": 0,
    "errors": [],
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:31:45.000Z"
  },
  "timestamp": "2025-01-15T10:31:50.000Z"
}

Response Fields

Field	Type	Description
`uploadId`	string	The upload request ID
`status`	string	Current processing status (see table above)
`totalRows`	number	Total number of data rows in the uploaded file
`created`	number	Number of new policies created
`updated`	number	Number of existing policies updated (duplicate `policyNumber` re-uploads)
`failed`	number	Number of rows that failed processing
`errors`	array	Details about individual row failures (see below)
`createdAt`	string	ISO 8601 timestamp when the upload was initiated
`updatedAt`	string	ISO 8601 timestamp of the last status update

Error Object

Each entry in the errors array describes a single row failure:

Field	Type	Description
`index`	number	Zero-based index of the failed row
`policyNumber`	string?	Policy number from the failed row (if available)
`error`	string	Human-readable error message

Example Responses

In Progress

{
  "statusCode": 200,
  "data": {
    "uploadId": "6650a1b2c3d4e5f6a7b8c9d0",
    "status": "PROCESSING",
    "totalRows": 1000,
    "created": 342,
    "updated": 58,
    "failed": 0,
    "errors": [],
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:30:45.000Z"
  }
}

Completed With Failures

{
  "statusCode": 200,
  "data": {
    "uploadId": "6650a1b2c3d4e5f6a7b8c9d0",
    "status": "COMPLETED_WITH_FAILURES",
    "totalRows": 1000,
    "created": 845,
    "updated": 147,
    "failed": 8,
    "errors": [
      {
        "index": 0,
        "policyNumber": "POL-2025-001",
        "error": "Missing required field: riskStateCode"
      },
      {
        "index": 47,
        "policyNumber": "POL-2025-048",
        "error": "Invalid date format for policyTransactionDate"
      }
    ],
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:31:45.000Z"
  }
}

Error Scenarios

Upload Not Found (404)

Returned when uploadId doesn’t exist or belongs to a different upstream entity.

{
  "statusCode": 404,
  "errorType": "not_found",
  "errorMessage": ["Upload not found"],
  "requestId": "dev-abc123",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Unauthorized (401)

Missing or invalid authentication token. See Authentication.

Path Parameters

uploadId

string

required

ID of the upload request returned by POST /policies/upload

Example:

"6650a1b2c3d4e5f6a7b8c9d0"

Response

Upload processing status with record counts and errors

uploadId

string

required

ID of the upload request

Example:

"6650a1b2c3d4e5f6a7b8c9d0"

status

enum<string>

required

Current processing status

Available options:

QUEUED,

PROCESSING,

COMPLETED,

COMPLETED_WITH_FAILURES,

NEEDS_CLARIFICATION,

CANCELLED,

FAILED

Example:

"COMPLETED"

totalRows

number

required

Total number of data rows in the uploaded file

Example:

1000

created

number

required

Number of new policies created

Example:

851

updated

number

required

Number of existing policies updated (duplicate policyNumber re-uploads)

Example:

149

failed

number

required

Number of rows that failed processing

Example:

0

errors

object[]

required

Details about individual row failures

Show child attributes

createdAt

string

required

ISO 8601 timestamp when the upload was initiated

Example:

"2025-01-15T10:30:00.000Z"

updatedAt

string

required

ISO 8601 timestamp of the last status update

Example:

"2025-01-15T10:31:45.000Z"

Start Here

Shared Endpoints

Products

Agencies You Appoint

Contract Container Templates

Agents

Contacts

Market Contacts

Licenses

Appointments

Compliance Data Subscriptions

Compliance Status

File Documents

Policy Ingestion

Policy Transactions

Surplus Lines Filings

Webhooks

E&O/Cyber Compliance

Regulatory Actions

Tools

Polling Strategy

Status Values

Response Shape

Response Fields

Error Object

Example Responses

In Progress

Completed With Failures

Error Scenarios

Upload Not Found (404)

Unauthorized (401)

Path Parameters

Response

​Polling Strategy

​Status Values

​Response Shape

​Response Fields

​Error Object

​Example Responses

​In Progress

​Completed With Failures

​Error Scenarios

​Upload Not Found (404)

​Unauthorized (401)

Path Parameters

Response

Polling Strategy

Status Values

Response Shape

Response Fields

Error Object

Example Responses

In Progress

Completed With Failures

Error Scenarios

Upload Not Found (404)

Unauthorized (401)