Skip to main content
PATCH
/
api
/
v1
/
submission
/
{id}
Update Submission Details
curl --request PATCH \
  --url https://vision.pingintel.com/api/v1/submission/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_ref": "<string>",
  "new_renewal": "New",
  "inception_date": "2023-12-25",
  "expiration_date": "2023-12-25",
  "need_by_date": "2023-12-25",
  "insured_name": "<string>",
  "insured_street": "<string>",
  "insured_street2": "<string>",
  "insured_city": "<string>",
  "insured_state": "<string>",
  "insured_zip": "<string>",
  "insured_fein": "<string>",
  "insured_country": "<string>",
  "home_state": "<string>",
  "insured_business_description": "<string>",
  "risk_summary": "<string>",
  "broker_name": "<string>",
  "broker_email": "jsmith@example.com",
  "broker_street": "<string>",
  "broker_street2": "<string>",
  "broker_city": "<string>",
  "broker_state": "<string>",
  "broker_zip": "<string>",
  "broker_fein": "<string>",
  "broker_country": "<string>",
  "broker_phone": "<string>",
  "broker_contact_name": "<string>",
  "broker_assistant_name": "<string>",
  "broker_license_number": "<string>",
  "broker_license_state": "<string>",
  "insured_website": "<string>",
  "insured_sic": "<string>",
  "insured_gl_code": "<string>",
  "primary_naics_code": 1073741823,
  "insured_contact_name": "<string>",
  "insured_contact_email": "jsmith@example.com",
  "insured_contact_phone": "<string>",
  "insured_ofac_status": "N",
  "is_building_data_ready": true,
  "target_terms": "<string>",
  "wholesale_broker_name": "<string>",
  "wholesale_broker_email": "jsmith@example.com",
  "wholesale_broker_street": "<string>",
  "wholesale_broker_street2": "<string>",
  "wholesale_broker_city": "<string>",
  "wholesale_broker_state": "<string>",
  "wholesale_broker_zip": "<string>",
  "wholesale_broker_country": "<string>",
  "wholesale_broker_contact_name": "<string>",
  "wholesale_broker_assistant_name": "<string>",
  "ceding_company_name": "<string>",
  "ceding_company_street": "<string>",
  "ceding_company_street2": "<string>",
  "ceding_company_city": "<string>",
  "ceding_company_state": "<string>",
  "ceding_company_zip": "<string>",
  "ceding_company_country": "<string>",
  "ceding_company_assistant_name": "<string>",
  "fac_re_company_name": "<string>",
  "fac_re_company_street": "<string>",
  "fac_re_company_street2": "<string>",
  "fac_re_company_city": "<string>",
  "fac_re_company_state": "<string>",
  "fac_re_company_zip": "<string>",
  "fac_re_company_country": "<string>",
  "fac_re_company_contact_name": "<string>",
  "fac_re_company_assistant_name": "<string>",
  "fac_re_broker_company_name": "<string>",
  "fac_re_broker_company_street": "<string>",
  "fac_re_broker_company_street2": "<string>",
  "fac_re_broker_company_city": "<string>",
  "fac_re_broker_company_state": "<string>",
  "fac_re_broker_company_zip": "<string>",
  "fac_re_broker_company_country": "<string>",
  "fac_re_broker_company_contact_name": "<string>",
  "fac_re_broker_company_assistant_name": "<string>",
  "underwriter_name": "<string>",
  "underwriter_street": "<string>",
  "underwriter_street2": "<string>",
  "underwriter_city": "<string>",
  "underwriter_state": "<string>",
  "underwriter_zip": "<string>",
  "underwriter_country": "<string>",
  "underwriter_contact_name": "<string>",
  "underwriter_assistant_name": "<string>",
  "is_rush": true
}
'
{
  "broker_full_address": "<string>",
  "num_buildings": 123,
  "client_ref": "<string>",
  "new_renewal": "New",
  "inception_date": "2023-12-25",
  "expiration_date": "2023-12-25",
  "need_by_date": "2023-12-25",
  "insured_name": "<string>",
  "insured_street": "<string>",
  "insured_street2": "<string>",
  "insured_city": "<string>",
  "insured_state": "<string>",
  "insured_zip": "<string>",
  "insured_fein": "<string>",
  "insured_country": "<string>",
  "home_state": "<string>",
  "insured_business_description": "<string>",
  "risk_summary": "<string>",
  "broker_name": "<string>",
  "broker_email": "jsmith@example.com",
  "broker_street": "<string>",
  "broker_street2": "<string>",
  "broker_city": "<string>",
  "broker_state": "<string>",
  "broker_zip": "<string>",
  "broker_fein": "<string>",
  "broker_country": "<string>",
  "broker_phone": "<string>",
  "broker_contact_name": "<string>",
  "broker_assistant_name": "<string>",
  "broker_license_number": "<string>",
  "broker_license_state": "<string>",
  "insured_website": "<string>",
  "insured_sic": "<string>",
  "insured_gl_code": "<string>",
  "primary_naics_code": 1073741823,
  "insured_contact_name": "<string>",
  "insured_contact_email": "jsmith@example.com",
  "insured_contact_phone": "<string>",
  "insured_ofac_status": "N",
  "is_building_data_ready": true,
  "target_terms": "<string>",
  "wholesale_broker_name": "<string>",
  "wholesale_broker_email": "jsmith@example.com",
  "wholesale_broker_street": "<string>",
  "wholesale_broker_street2": "<string>",
  "wholesale_broker_city": "<string>",
  "wholesale_broker_state": "<string>",
  "wholesale_broker_zip": "<string>",
  "wholesale_broker_country": "<string>",
  "wholesale_broker_contact_name": "<string>",
  "wholesale_broker_assistant_name": "<string>",
  "ceding_company_name": "<string>",
  "ceding_company_street": "<string>",
  "ceding_company_street2": "<string>",
  "ceding_company_city": "<string>",
  "ceding_company_state": "<string>",
  "ceding_company_zip": "<string>",
  "ceding_company_country": "<string>",
  "ceding_company_assistant_name": "<string>",
  "fac_re_company_name": "<string>",
  "fac_re_company_street": "<string>",
  "fac_re_company_street2": "<string>",
  "fac_re_company_city": "<string>",
  "fac_re_company_state": "<string>",
  "fac_re_company_zip": "<string>",
  "fac_re_company_country": "<string>",
  "fac_re_company_contact_name": "<string>",
  "fac_re_company_assistant_name": "<string>",
  "fac_re_broker_company_name": "<string>",
  "fac_re_broker_company_street": "<string>",
  "fac_re_broker_company_street2": "<string>",
  "fac_re_broker_company_city": "<string>",
  "fac_re_broker_company_state": "<string>",
  "fac_re_broker_company_zip": "<string>",
  "fac_re_broker_company_country": "<string>",
  "fac_re_broker_company_contact_name": "<string>",
  "fac_re_broker_company_assistant_name": "<string>",
  "underwriter_name": "<string>",
  "underwriter_street": "<string>",
  "underwriter_street2": "<string>",
  "underwriter_city": "<string>",
  "underwriter_state": "<string>",
  "underwriter_zip": "<string>",
  "underwriter_country": "<string>",
  "underwriter_contact_name": "<string>",
  "underwriter_assistant_name": "<string>",
  "is_rush": true
}

Authorizations

​
Authorization
string
header
required

Supports Token-prefixed API keys and Bearer-prefixed JWT-based authentication.

Path Parameters

​
id
string
required

The pingid of the submission.

Body

​
client_ref
string | null
Maximum string length: 2000
​
new_renewal
enum<string> | null

Whether the submission is for a new policy or a renewal.

  • New - New
  • Renewal - Renewal
Available options:
New,
Renewal,
,
null
​
inception_date
string<date> | null
​
expiration_date
string<date> | null
​
need_by_date
string<date> | null
​
insured_name
string | null
Maximum string length: 2000
​
insured_street
string | null
Maximum string length: 2000
​
insured_street2
string | null
Maximum string length: 2000
​
insured_city
string | null
Maximum string length: 2000
​
insured_state
string | null
Maximum string length: 2000
​
insured_zip
string | null
Maximum string length: 2000
​
insured_fein
string | null
Maximum string length: 2000
​
insured_country
string | null
Maximum string length: 2000
​
home_state
string | null
Maximum string length: 255
​
insured_business_description
string | null
​
risk_summary
string | null

AI generated risk summary (generated by InsuredAgent())

Maximum string length: 1000
​
broker_name
string | null
Maximum string length: 255
​
broker_email
string<email> | null
Maximum string length: 254
​
broker_street
string | null
Maximum string length: 2000
​
broker_street2
string | null
Maximum string length: 2000
​
broker_city
string | null
Maximum string length: 2000
​
broker_state
string | null
Maximum string length: 2000
​
broker_zip
string | null
Maximum string length: 2000
​
broker_fein
string | null
Maximum string length: 2000
​
broker_country
string | null
Maximum string length: 2000
​
broker_phone
string | null
Maximum string length: 255
​
broker_contact_name
string | null
Maximum string length: 2000
​
broker_assistant_name
string | null
Maximum string length: 2000
​
broker_license_number
string | null
Maximum string length: 255
​
broker_license_state
string | null
Maximum string length: 2000
​
insured_website
string | null
Maximum string length: 255
​
insured_sic
string | null
Maximum string length: 255
​
insured_gl_code
string | null
Maximum string length: 255
​
primary_naics_code
integer | null

Primary NAICS code for the submission, denormalized from Location

Required range: 0 <= x <= 2147483647
​
insured_contact_name
string | null
Maximum string length: 255
​
insured_contact_email
string<email> | null
Maximum string length: 254
​
insured_contact_phone
string | null
Maximum string length: 255
​
insured_ofac_status
enum<string> | null
  • N - Not Run
  • U - Unblocked
  • B - Blocked
Available options:
N,
U,
B,
,
null
​
is_building_data_ready
boolean | null
​
target_terms
string | null
​
wholesale_broker_name
string | null
Maximum string length: 255
​
wholesale_broker_email
string<email> | null
Maximum string length: 255
​
wholesale_broker_street
string | null
Maximum string length: 255
​
wholesale_broker_street2
string | null
Maximum string length: 255
​
wholesale_broker_city
string | null
Maximum string length: 255
​
wholesale_broker_state
string | null
Maximum string length: 255
​
wholesale_broker_zip
string | null
Maximum string length: 255
​
wholesale_broker_country
string | null
Maximum string length: 255
​
wholesale_broker_contact_name
string | null
Maximum string length: 255
​
wholesale_broker_assistant_name
string | null
Maximum string length: 255
​
ceding_company_name
string | null
Maximum string length: 255
​
ceding_company_street
string | null
Maximum string length: 255
​
ceding_company_street2
string | null
Maximum string length: 255
​
ceding_company_city
string | null
Maximum string length: 255
​
ceding_company_state
string | null
Maximum string length: 255
​
ceding_company_zip
string | null
Maximum string length: 255
​
ceding_company_country
string | null
Maximum string length: 255
​
ceding_company_assistant_name
string | null
Maximum string length: 255
​
fac_re_company_name
string | null
Maximum string length: 255
​
fac_re_company_street
string | null
Maximum string length: 255
​
fac_re_company_street2
string | null
Maximum string length: 255
​
fac_re_company_city
string | null
Maximum string length: 255
​
fac_re_company_state
string | null
Maximum string length: 255
​
fac_re_company_zip
string | null
Maximum string length: 255
​
fac_re_company_country
string | null
Maximum string length: 255
​
fac_re_company_contact_name
string | null
Maximum string length: 255
​
fac_re_company_assistant_name
string | null
Maximum string length: 255
​
fac_re_broker_company_name
string | null
Maximum string length: 255
​
fac_re_broker_company_street
string | null
Maximum string length: 255
​
fac_re_broker_company_street2
string | null
Maximum string length: 255
​
fac_re_broker_company_city
string | null
Maximum string length: 255
​
fac_re_broker_company_state
string | null
Maximum string length: 255
​
fac_re_broker_company_zip
string | null
Maximum string length: 255
​
fac_re_broker_company_country
string | null
Maximum string length: 255
​
fac_re_broker_company_contact_name
string | null
Maximum string length: 255
​
fac_re_broker_company_assistant_name
string | null
Maximum string length: 255
​
underwriter_name
string | null
Maximum string length: 255
​
underwriter_street
string | null
Maximum string length: 255
​
underwriter_street2
string | null
Maximum string length: 255
​
underwriter_city
string | null
Maximum string length: 255
​
underwriter_state
string | null
Maximum string length: 255
​
underwriter_zip
string | null
Maximum string length: 255
​
underwriter_country
string | null
Maximum string length: 255
​
underwriter_contact_name
string | null
Maximum string length: 255
​
underwriter_assistant_name
string | null
Maximum string length: 255
​
is_rush
boolean | null

A flag to indicate that this submission is a rush job.

Response

​
broker_full_address
string
required
​
num_buildings
integer | null
required

The number of buildings in the submission (denormalized from Location)

​
client_ref
string | null
Maximum string length: 2000
​
new_renewal
enum<string> | null

Whether the submission is for a new policy or a renewal.

  • New - New
  • Renewal - Renewal
Available options:
New,
Renewal,
,
null
​
inception_date
string<date> | null
​
expiration_date
string<date> | null
​
need_by_date
string<date> | null
​
insured_name
string | null
Maximum string length: 2000
​
insured_street
string | null
Maximum string length: 2000
​
insured_street2
string | null
Maximum string length: 2000
​
insured_city
string | null
Maximum string length: 2000
​
insured_state
string | null
Maximum string length: 2000
​
insured_zip
string | null
Maximum string length: 2000
​
insured_fein
string | null
Maximum string length: 2000
​
insured_country
string | null
Maximum string length: 2000
​
home_state
string | null
Maximum string length: 255
​
insured_business_description
string | null
​
risk_summary
string | null

AI generated risk summary (generated by InsuredAgent())

Maximum string length: 1000
​
broker_name
string | null
Maximum string length: 255
​
broker_email
string<email> | null
Maximum string length: 254
​
broker_street
string | null
Maximum string length: 2000
​
broker_street2
string | null
Maximum string length: 2000
​
broker_city
string | null
Maximum string length: 2000
​
broker_state
string | null
Maximum string length: 2000
​
broker_zip
string | null
Maximum string length: 2000
​
broker_fein
string | null
Maximum string length: 2000
​
broker_country
string | null
Maximum string length: 2000
​
broker_phone
string | null
Maximum string length: 255
​
broker_contact_name
string | null
Maximum string length: 2000
​
broker_assistant_name
string | null
Maximum string length: 2000
​
broker_license_number
string | null
Maximum string length: 255
​
broker_license_state
string | null
Maximum string length: 2000
​
insured_website
string | null
Maximum string length: 255
​
insured_sic
string | null
Maximum string length: 255
​
insured_gl_code
string | null
Maximum string length: 255
​
primary_naics_code
integer | null

Primary NAICS code for the submission, denormalized from Location

Required range: 0 <= x <= 2147483647
​
insured_contact_name
string | null
Maximum string length: 255
​
insured_contact_email
string<email> | null
Maximum string length: 254
​
insured_contact_phone
string | null
Maximum string length: 255
​
insured_ofac_status
enum<string> | null
  • N - Not Run
  • U - Unblocked
  • B - Blocked
Available options:
N,
U,
B,
,
null
​
is_building_data_ready
boolean | null
​
target_terms
string | null
​
wholesale_broker_name
string | null
Maximum string length: 255
​
wholesale_broker_email
string<email> | null
Maximum string length: 255
​
wholesale_broker_street
string | null
Maximum string length: 255
​
wholesale_broker_street2
string | null
Maximum string length: 255
​
wholesale_broker_city
string | null
Maximum string length: 255
​
wholesale_broker_state
string | null
Maximum string length: 255
​
wholesale_broker_zip
string | null
Maximum string length: 255
​
wholesale_broker_country
string | null
Maximum string length: 255
​
wholesale_broker_contact_name
string | null
Maximum string length: 255
​
wholesale_broker_assistant_name
string | null
Maximum string length: 255
​
ceding_company_name
string | null
Maximum string length: 255
​
ceding_company_street
string | null
Maximum string length: 255
​
ceding_company_street2
string | null
Maximum string length: 255
​
ceding_company_city
string | null
Maximum string length: 255
​
ceding_company_state
string | null
Maximum string length: 255
​
ceding_company_zip
string | null
Maximum string length: 255
​
ceding_company_country
string | null
Maximum string length: 255
​
ceding_company_assistant_name
string | null
Maximum string length: 255
​
fac_re_company_name
string | null
Maximum string length: 255
​
fac_re_company_street
string | null
Maximum string length: 255
​
fac_re_company_street2
string | null
Maximum string length: 255
​
fac_re_company_city
string | null
Maximum string length: 255
​
fac_re_company_state
string | null
Maximum string length: 255
​
fac_re_company_zip
string | null
Maximum string length: 255
​
fac_re_company_country
string | null
Maximum string length: 255
​
fac_re_company_contact_name
string | null
Maximum string length: 255
​
fac_re_company_assistant_name
string | null
Maximum string length: 255
​
fac_re_broker_company_name
string | null
Maximum string length: 255
​
fac_re_broker_company_street
string | null
Maximum string length: 255
​
fac_re_broker_company_street2
string | null
Maximum string length: 255
​
fac_re_broker_company_city
string | null
Maximum string length: 255
​
fac_re_broker_company_state
string | null
Maximum string length: 255
​
fac_re_broker_company_zip
string | null
Maximum string length: 255
​
fac_re_broker_company_country
string | null
Maximum string length: 255
​
fac_re_broker_company_contact_name
string | null
Maximum string length: 255
​
fac_re_broker_company_assistant_name
string | null
Maximum string length: 255
​
underwriter_name
string | null
Maximum string length: 255
​
underwriter_street
string | null
Maximum string length: 255
​
underwriter_street2
string | null
Maximum string length: 255
​
underwriter_city
string | null
Maximum string length: 255
​
underwriter_state
string | null
Maximum string length: 255
​
underwriter_zip
string | null
Maximum string length: 255
​
underwriter_country
string | null
Maximum string length: 255
​
underwriter_contact_name
string | null
Maximum string length: 255
​
underwriter_assistant_name
string | null
Maximum string length: 255
​
is_rush
boolean | null

A flag to indicate that this submission is a rush job.