---
title: "Trident APIs"
url: "https://apipartners.mosaicinsurance.com/apis/trident-ap-is-stable/versions/3435c052-86bc-4226-afbf-c3af7c3342e9"
---

# Trident APIs

OpenAPI specification document.

```json
{"openapi":"3.0.1","info":{"title":"Trident APIs","description":"# Trident APIs\n\nThe Trident APIs let you create and progress cyber insurance submissions through their full lifecycle and look up reference data used across the platform.\n\n## Authentication\n\nAll endpoints require an API key sent in the `x-api-key` header.\n\n## Conventions\n\n- All requests and responses use `application/json`.\n- Dates use ISO 8601 (`YYYY-MM-DD`).\n- Lookup objects accept any one of `id`, `code`, or `description` — supply whichever you have. When more than one is provided, `id` takes precedence.\n- Errors follow a uniform shape (`code`, `message`) and use standard HTTP status codes.\n\n### Field requirement levels\n\nEvery request field is one of three levels, derived from the XFI SOP *Mandatory* rules:\n\n- **Required** — listed in the schema `required` array; the request is rejected if absent.\n- **Conditional** — required only when a stated condition holds (e.g. LOB, country of origin, new contact). The condition is described in the field and carried in the machine-readable `x-conditional-required` extension; the field is **not** in `required`.\n- **Optional** — supply only if known.\n\n## Submission lifecycle\n\n1. **Base** — `POST /submission/base` creates a new DRAFT cyber submission and returns `policyKey` and `policyActivityKey`.\n2. **Full** — `POST /submission/full?policyKey={policyKey}&policyActivityKey={policyActivityKey}` enriches the draft with underwriting and classification data.\n3. **Quote** — `POST /submission/quote?policyKey={policyKey}&policyActivityKey={policyActivityKey}` adds pricing and section data.\n\nA single-call orchestration of the entire lifecycle (Base + Full → Quote → Bind) is also available via `POST /submission/global`.","termsOfService":"https://www.connecttrident.com/terms","contact":{"name":"Trident API Support","url":"https://www.connecttrident.com/support"},"license":{"name":"Proprietary","url":"https://www.connecttrident.com/terms"},"version":"preprod"},"servers":[{"url":"https://apinonprod.mosaicinsurance.com","description":"Generated server url"}],"x-amazon-apigateway-gateway-responses":{"DEFAULT_4XX":{"responseParameters":{"gatewayresponse.header.Access-Control-Allow-Origin":"'*'","gatewayresponse.header.Access-Control-Allow-Headers":"'Content-Type,X-Amz-Date,Authorization,X-Api-Key,x-api-key,multipart/form-data'","gatewayresponse.header.Access-Control-Allow-Methods":"'GET,POST,PUT,DELETE,OPTIONS,PATCH'"}},"DEFAULT_5XX":{"responseParameters":{"gatewayresponse.header.Access-Control-Allow-Origin":"'*'","gatewayresponse.header.Access-Control-Allow-Headers":"'Content-Type,X-Amz-Date,Authorization,X-Api-Key,x-api-key,multipart/form-data'","gatewayresponse.header.Access-Control-Allow-Methods":"'GET,POST,PUT,DELETE,OPTIONS,PATCH'"}}},"paths":{"/submission/list":{"get":{"security":[{"api_key":[]}],"tags":["Submission Data Extraction"],"summary":"List submissions","description":"Retrieves a list of submissions filtered by source (e.g., MEA), class of business (e.g., cyber), and date range. Returns submission summary information including insured, broker, underwriter, dates, and status flags.","operationId":"getSubmissionsList","parameters":[{"name":"classOfBusiness","in":"query","description":"Class of business type (e.g., cyber)","required":true,"schema":{"type":"string"},"example":"cyber"},{"name":"fromDate","in":"query","description":"Start timestamp for filtering submissions (YYYY-MM-DDTHH:MM:SS)","required":false,"schema":{"type":"string","format":"date-time"},"example":"2024-01-01T00:00:00"},{"name":"toDate","in":"query","description":"End timestamp for filtering submissions (YYYY-MM-DDTHH:MM:SS)","required":false,"schema":{"type":"string","format":"date-time"},"example":"2024-12-31T23:59:59"}],"responses":{"200":{"description":"Submissions list retrieved successfully","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"}},"Access-Control-Allow-Methods":{"schema":{"type":"string"}},"Access-Control-Allow-Headers":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubmissionListItem"}},"examples":{"Submissions List Example":{"description":"Submissions List Example","value":[{"brokerCompany":"Marsh USA LLC","activityExpiryDate":"2025-07-01","submissionId":"CY01-20241015135400","insured":"","activityEffectiveDate":"2024-07-01","creationDate":"2024-10-15 19:10:00","underwriter":"Eric Kerr"},{"brokerCompany":"Aon (Bermuda) Ltd","activityExpiryDate":"2024-11-30","submissionId":"CY01-20231026100555","insured":"Veritas Capital Group GP, LLC","activityEffectiveDate":"2023-11-30","creationDate":"2024-06-25 12:06:00","underwriter":""},{"brokerCompany":"Strom Winds, Inc.,","activityExpiryDate":"2023-06-13","submissionId":"8563","insured":"U S Bancorp","activityEffectiveDate":"2022-06-13","creationDate":"2024-06-20 22:06:00","underwriter":"Lopez, Daisy"}]}}}}},"400":{"description":"Bad request - invalid source or class of business","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"}},"Access-Control-Allow-Methods":{"schema":{"type":"string"}},"Access-Control-Allow-Headers":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing authentication token","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"}},"Access-Control-Allow-Methods":{"schema":{"type":"string"}},"Access-Control-Allow-Headers":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"Authentication Error":{"description":"Authentication Error","value":{"error":{"code":"401","message":"Unauthorized"}}}}}}},"500":{"description":"Internal server error","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"}},"Access-Control-Allow-Methods":{"schema":{"type":"string"}},"Access-Control-Allow-Headers":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/submission/getById":{"get":{"security":[{"api_key":[]}],"tags":["Submission Data Extraction"],"summary":"Get submission by id","description":"Retrieves submission data for a specific submission ID based on the class of business (cyber, pv, or enviro). Returns the submission details in a HashMap with the class of business as the key.","operationId":"getSubmissionWithId","parameters":[{"name":"id","in":"query","description":"Unique submission identifier","required":true,"schema":{"type":"string"},"example":"CY01-20251015-14"}],"responses":{"200":{"description":"MEA submission found and returned successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionJson"},"examples":{"MEA Submission Response":{"summary":"Example of a successfully retrieved MEA submission","description":"MEA Submission Response","value":{"brokerCompany":"Lockton Companies, LLC","brokerCompanyConfidenceScore":"95","brokerContactName":"Jane Broker","brokerContactNameConfidenceScore":"90","brokerEmail":"jane.broker@lockton.com","brokerEmailConfidenceScore":"98","brokerPhoneNo":"+1-415-555-0199","brokerPhoneNoConfidenceScore":"85","insuredName":"Llyods Associates Inc","insuredNameConfidenceScore":"97","insuredAddressStreet":"1125 Cedar Street","insuredAddressStreetConfidenceScore":"88","insuredAddressCity":"Green Bay","insuredAddressCityConfidenceScore":"92","insuredAddressState":"California","insuredAddressStateConfidenceScore":"91","insuredAddressCountry":"United States","insuredAddressCountryConfidenceScore":"99","insuredAddressZip":"94102","insuredAddressZipConfidenceScore":"87","underwriter":"John Smith","underwriterConfidenceScore":"93","underwriterEmail":"john.smith@mosaic.com","underwriterEmailConfidenceScore":"96","underwriterTitle":"Senior Underwriter","underwriterTitleConfidenceScore":"80","currency":"USD","currencyConfidenceScore":"99","activityEffectiveDate":"2026-04-06","activityEffectiveDateConfidenceScore":"94","activityExpiryDate":"2027-04-06","activityExpiryDateConfidenceScore":"94","limitOfLiability":"5000000","limitOfLiabilityConfidenceScore":"89","premium":"15000","premiumConfidenceScore":"92","commission":"15","commissionConfidenceScore":"88","territory":"United States","territoryConfidenceScore":"95","revTurnover":"50000000","revTurnoverConfidenceScore":"82","noOfEmployees":"500","noOfEmployeesConfidenceScore":"78","mosaicOccupation":"Software Development","mosaicOccupationConfidenceScore":"86","mop":"Standard Policy","mopConfidenceScore":"90","directOrAssumed":"Direct","directOrAssumedConfidenceScore":"97","excess":"250000","excessConfidenceScore":"84","noOfPIIRecords":"10000","noOfPIIRecordsConfidenceScore":"75","webSite":"https://www.example.com","webSiteConfidenceScore":"91","globalRisk":"NO","globalRiskConfidenceScore":"88"}}}}}},"404":{"description":"Submission not found - No MEA submission exists for the given ID","content":{"application/json":{"examples":{"Not Found":{"summary":"Submission ID does not exist","description":"Not Found","value":{"error":{"code":"NOT_FOUND","message":"No MEA submission found for ID: SUB123456"}}}}}}},"500":{"description":"Internal server error - Unexpected error while retrieving submission","content":{"application/json":{"examples":{"Internal Server Error":{"summary":"Unexpected error during retrieval","description":"Internal Server Error","value":{"error":{"code":"INTERNAL_ERROR","message":"Failed to retrieve MEA submission: Database connection timeout"}}}}}}}}}},"/mea/submission":{"post":{"security":[{"api_key":[]}],"tags":["Submission Data Extraction"],"summary":"Push MEA Submission","description":"Pushes Machine Email Analysis (MEA) submission extraction data for the selected class of business.","operationId":"pushMeaSubmission","parameters":[{"name":"classOfBusiness","in":"query","description":"Class of business for the submission.","required":true,"schema":{"type":"string","enum":["cyber","enviro","FL01","PL01"]},"example":"cyber"},{"name":"submission-id","in":"header","description":"Unique submission identifier.","required":true,"schema":{"type":"string"},"example":"CY01-20260303-28"},{"name":"inputFileName","in":"header","description":"Base64-encoded input file name.","required":true,"schema":{"type":"string"},"example":"Q1kwMS0yMDI2MDMwNS0zNS5lbWw="}],"requestBody":{"required":true,"description":"Nested extraction rows. Each cell contains a value; rows commonly contain a field name, extracted value, and confidence score.","content":{"application/json":{"schema":{"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"object","required":["value"],"properties":{"value":{"type":"string"}},"additionalProperties":false}}}},"example":[[[{"value":"Entity Name"},{"value":"Output 1"},{"value":"Confidence Score %"}],[{"value":"Producer (Broker Company)"},{"value":"INSUREtrust"},{"value":"0.96"}],[{"value":"Insured"},{"value":"PerkinElmer U.S. LLC"},{"value":"0.96"}]]]}}},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"SubmissionJson":{"type":"object","properties":{"externalSourceId":{"type":"string"},"creationDate":{"type":"string"},"insuredName":{"type":"string"},"insuredNameConfidenceScore":{"type":"string"},"insuredAddressStreet":{"type":"string"},"insuredAddressStreetConfidenceScore":{"type":"string"},"insuredAddressCity":{"type":"string"},"insuredAddressCityConfidenceScore":{"type":"string"},"insuredAddressCountry":{"type":"string"},"insuredAddressCountryConfidenceScore":{"type":"string"},"insuredAddressState":{"type":"string"},"insuredAddressStateConfidenceScore":{"type":"string"},"insuredAddressZip":{"type":"string"},"insuredAddressZipConfidenceScore":{"type":"string"},"brokerCompany":{"type":"string"},"brokerCompanyConfidenceScore":{"type":"string"},"brokerContactName":{"type":"string"},"brokerContactNameConfidenceScore":{"type":"string"},"brokerPhoneNo":{"type":"string"},"brokerPhoneNoConfidenceScore":{"type":"string"},"brokerEmail":{"type":"string"},"brokerEmailConfidenceScore":{"type":"string"},"brokerAddressStreet":{"type":"string"},"brokerAddressStreetConfidenceScore":{"type":"string"},"brokerAddressCity":{"type":"string"},"brokerAddressCityConfidenceScore":{"type":"string"},"brokerAddressCountry":{"type":"string"},"brokerAddressCountryConfidenceScore":{"type":"string"},"brokerAddressCountryIsoCode":{"type":"string"},"brokerAddressState":{"type":"string"},"brokerAddressStateConfidenceScore":{"type":"string"},"brokerAddressZip":{"type":"string"},"brokerAddressZipConfidenceScore":{"type":"string"},"licenseNumber":{"type":"string"},"underwriter":{"type":"string"},"underwriterConfidenceScore":{"type":"string"},"underwriterTitle":{"type":"string"},"underwriterTitleConfidenceScore":{"type":"string"},"underwriterEmail":{"type":"string"},"underwriterEmailConfidenceScore":{"type":"string"},"mobile":{"type":"string"},"currency":{"type":"string"},"currencyConfidenceScore":{"type":"string"},"activityEffectiveDate":{"type":"string"},"activityEffectiveDateConfidenceScore":{"type":"string"},"activityExpiryDate":{"type":"string"},"activityExpiryDateConfidenceScore":{"type":"string"},"limitOfLiability":{"type":"string"},"limitOfLiabilityConfidenceScore":{"type":"string"},"partOf":{"type":"string"},"partOfConfidenceScore":{"type":"string"},"excess":{"type":"string"},"excessConfidenceScore":{"type":"string"},"premium":{"type":"string"},"premiumConfidenceScore":{"type":"string"},"lineSize":{"type":"string"},"commission":{"type":"string"},"commissionConfidenceScore":{"type":"string"},"followedPolicyInsurer":{"type":"string"},"followedPolicyInsurerConfidenceScore":{"type":"string"},"followedPolicyForm":{"type":"string"},"followedPolicyFormConfidenceScore":{"type":"string"},"followedPolicyPolicyNumber":{"type":"string"},"followedPolicyPolicyNumberConfidenceScore":{"type":"string"},"followedPolicyLimitOfLiability":{"type":"string"},"followedPolicyLimitOfLiabilityConfidenceScore":{"type":"string"},"followedPolicyRetention":{"type":"string"},"followedPolicyRetentionConfidenceScore":{"type":"string"},"noticeOfClaim":{"type":"string"},"noticeOfClaimConfidenceScore":{"type":"string"},"coverage":{"type":"string"},"coverageConfidenceScore":{"type":"string"},"directOrAssumed":{"type":"string"},"directOrAssumedConfidenceScore":{"type":"string"},"reassured":{"type":"string"},"reassuredConfidenceScore":{"type":"string"},"mosaicOccupation":{"type":"string"},"mosaicOccupationConfidenceScore":{"type":"string"},"mop":{"type":"string"},"mopConfidenceScore":{"type":"string"},"territory":{"type":"string"},"territoryConfidenceScore":{"type":"string"},"revTurnover":{"type":"string"},"revTurnoverConfidenceScore":{"type":"string"},"noOfEmployees":{"type":"string"},"noOfEmployeesConfidenceScore":{"type":"string"},"webSite":{"type":"string"},"webSiteConfidenceScore":{"type":"string"},"noOfPIIRecords":{"type":"string"},"noOfPIIRecordsConfidenceScore":{"type":"string"},"facility":{"type":"string"},"facilityConfidenceScore":{"type":"string"},"subProduct":{"type":"string"},"subProductConfidenceScore":{"type":"string"},"perClaimLimit":{"type":"string"},"perClaimLimitConfidenceScore":{"type":"string"},"primaryExcess":{"type":"string"},"primaryExcessConfidenceScore":{"type":"string"},"mosaicSubProduct":{"type":"string"},"mosaicSubProductConfidenceScore":{"type":"string"},"typeOfPeriod":{"type":"string"},"typeOfPeriodConfidenceScore":{"type":"string"},"globalRisk":{"type":"string"},"globalRiskConfidenceScore":{"type":"string"},"surplusLineBrokerName":{"type":"string"},"surplusLineBrokerNameConfidenceScore":{"type":"string"},"surplusLinesBrokerAddress":{"type":"string"},"surplusLinesBrokerAddressConfidenceScore":{"type":"string"},"surplusLineBrokerNo":{"type":"string"},"surplusLineBrokerNoConfidenceScore":{"type":"string"},"surplusLineBrokerStateNumber":{"type":"string"},"surplusLineBrokerStateNumberConfidenceScore":{"type":"string"},"retroActiveDate":{"type":"string"},"retroActiveDateConfidenceScore":{"type":"string"},"invoiceNumber":{"type":"string"},"typeOfCyberRequest":{"type":"string"},"uwsignatureKey":{"type":"string"}},"required":["externalSourceId","creationDate","insuredName","insuredNameConfidenceScore","insuredAddressStreet","insuredAddressStreetConfidenceScore","insuredAddressCity","insuredAddressCityConfidenceScore","insuredAddressCountry","insuredAddressCountryConfidenceScore","insuredAddressState","insuredAddressStateConfidenceScore","insuredAddressZip","insuredAddressZipConfidenceScore","brokerCompany","brokerCompanyConfidenceScore","brokerContactName","brokerContactNameConfidenceScore","brokerPhoneNo","brokerPhoneNoConfidenceScore","brokerEmail","brokerEmailConfidenceScore","underwriter","underwriterConfidenceScore","underwriterTitle","underwriterTitleConfidenceScore","underwriterEmail","underwriterEmailConfidenceScore","currency","currencyConfidenceScore","activityEffectiveDate","activityEffectiveDateConfidenceScore","activityExpiryDate","activityExpiryDateConfidenceScore","limitOfLiability","limitOfLiabilityConfidenceScore","excess","excessConfidenceScore","premium","premiumConfidenceScore","territory","territoryConfidenceScore","revTurnover","revTurnoverConfidenceScore","noOfEmployees","noOfEmployeesConfidenceScore","mosaicOccupation","mosaicOccupationConfidenceScore","mop","mopConfidenceScore","directOrAssumed","directOrAssumedConfidenceScore","webSite","webSiteConfidenceScore","noOfPIIRecords","noOfPIIRecordsConfidenceScore","globalRisk","globalRiskConfidenceScore","typeOfPeriod","typeOfPeriodConfidenceScore","surplusLineBrokerName","surplusLineBrokerNameConfidenceScore","surplusLinesBrokerAddress","surplusLinesBrokerAddressConfidenceScore","surplusLineBrokerNo","surplusLineBrokerNoConfidenceScore","surplusLineBrokerStateNumber","surplusLineBrokerStateNumberConfidenceScore","retroActiveDate","retroActiveDateConfidenceScore","invoiceNumber","typeOfCyberRequest","uwsignatureKey"]},"SubmissionListItem":{"type":"object","properties":{"brokerCompany":{"type":"string"},"creationDate":{"type":"string"},"underwriter":{"type":"string"},"activityExpiryDate":{"type":"string","nullable":true},"activityEffectiveDate":{"type":"string","nullable":true},"submissionId":{"type":"string"},"insured":{"type":"string"}},"required":["brokerCompany","creationDate","submissionId","insured"]},"ErrorDetail":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/ErrorDetail"}}}},"securitySchemes":{"api_key":{"type":"apiKey","name":"x-api-key","in":"header"}},"parameters":{}},"tags":[{"name":"Submission Data Extraction","description":"Extract submission data for use in other systems."}]}
```