Broker Create Submission

POST

/api/v1/broker/submissions

const url = 'https://example.com/api/v1/broker/submissions';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"applicant":{"insured_name":"example","business_phone":"example","business_email":"example","website":"example","fein_or_ssn":"example","contact_first_name":"example","contact_last_name":"example","contact_title":"example","contact_phone":"example","contact_email":"example","mailing_address":{"line1":"example","city":"example","county":"example","state":"example","zip":"example","zip4":"example","line2":"example","country":"US"},"nature_of_business":"example","entity_type":"example","naics":"example","gl_code":"example","sic":"example","date_business_started":"2026-04-15"},"effective_date":"2026-04-15","lines_of_business":["example"],"property_tiv_total":1,"auto_vehicle_count":1,"wc_total_annual_payroll":1,"prior_carriers":[{"id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","coverage_category":"example","carrier_name":"example","loss_run_carrier_id":1,"policy_number":"example","effective_date":"2026-04-15","expiration_date":"2026-04-15"}],"narrative":"example","insured_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","producer_email":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/api/v1/broker/submissions \
  --header 'Content-Type: application/json' \
  --data '{ "applicant": { "insured_name": "example", "business_phone": "example", "business_email": "example", "website": "example", "fein_or_ssn": "example", "contact_first_name": "example", "contact_last_name": "example", "contact_title": "example", "contact_phone": "example", "contact_email": "example", "mailing_address": { "line1": "example", "city": "example", "county": "example", "state": "example", "zip": "example", "zip4": "example", "line2": "example", "country": "US" }, "nature_of_business": "example", "entity_type": "example", "naics": "example", "gl_code": "example", "sic": "example", "date_business_started": "2026-04-15" }, "effective_date": "2026-04-15", "lines_of_business": [ "example" ], "property_tiv_total": 1, "auto_vehicle_count": 1, "wc_total_annual_payroll": 1, "prior_carriers": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "coverage_category": "example", "carrier_name": "example", "loss_run_carrier_id": 1, "policy_number": "example", "effective_date": "2026-04-15", "expiration_date": "2026-04-15" } ], "narrative": "example", "insured_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "producer_email": "example" }'

Request Body^required

application/json

BrokerSubmissionCreateRequest

Broker-built submission. The brokerage is taken from the token, never from the client, there is no retail_brokerage_id field here on purpose. narrative is the broker’s free-text description of the risk (mirrors an inbound email body); it lands in the brief’s memory.

object

applicant

required

ApplicantCreate

object

insured_name

required

Insured Name

string

business_phone

Any of:

string
null

string

business_email

Any of:

string
null

string

website

Any of:

string
null

string

fein_or_ssn

Any of:

string
null

string

contact_first_name

Any of:

string
null

string

contact_last_name

Any of:

string
null

string

contact_title

Any of:

string
null

string

<= 128 characters

contact_phone

Any of:

string
null

string

contact_email

Any of:

string
null

string

mailing_address

Any of:

ApplicantAddressCreate
null

ApplicantAddressCreate

object

line1

required

Line1

string

city

required

City

string

county

Any of:

string
null

string

state

required

State

string

zip

required

Zip

string

zip4

Any of:

string
null

string

line2

Any of:

string
null

string

country

Country

string

default: US

nature_of_business

Any of:

string
null

string

entity_type

Any of:

string
null

string

naics

Any of:

string
null

string

gl_code

Any of:

string
null

string

<= 64 characters

sic

Any of:

string
null

string

<= 64 characters

date_business_started

Any of:

string
null

string format: date

effective_date

Any of:

string
null

string format: date

lines_of_business

Lines Of Business

Array<string>

property_tiv_total

Any of:

integer
null

integer

auto_vehicle_count

Any of:

integer
null

integer

wc_total_annual_payroll

Any of:

integer
null

integer

prior_carriers

Prior Carriers

Array<object>

SubmissionPriorCarrierInput

object

Any of:

string
null

string format: uuid

coverage_category

Any of:

string
null

string

carrier_name

Any of:

string
null

string

loss_run_carrier_id

Any of:

integer
null

integer

policy_number

Any of:

string
null

string

effective_date

Any of:

string
null

string format: date

expiration_date

Any of:

string
null

string format: date

narrative

Any of:

string
null

string

insured_id

Any of:

string
null

string format: uuid

producer_email

Any of:

string
null

string

Responses

201

Successful Response

application/json

BrokerSubmissionCreateResponse

object

submission_id

required

Submission Id

string format: uuid

state

Any of:

string
null

string

status_label

required

Status Label

string

Example^generated

{
  "submission_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "state": "example",
  "status_label": "example"
}

422

Validation Error

application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}

Broker Create Submission

Request Bodyrequired

Responses

201

Examplegenerated

422

Examplegenerated

Request Body^required

Example^generated

Example^generated