PPL Submissions API
Enables underwriters to retrieve Submission requests supplied by a broker and to manage their negotiation of terms of cover, including reassignment of a negotiation and sending a response back to the broker. This is the quote-side surface of the platform. OpenAPI 3.0.1, 8 paths and 10 operations.
PPL Submissions API is one of 5 APIs that PPL publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Submission, Negotiation, Quotes, and Underwriting. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 10 operations across 8 paths, organized into 4 resource areas, and defines 90 schemas. It is described by OpenAPI 3.0.1, at version 1.
Requests are made against a single base URL, https://sand-api.londonmarketgroup.co.uk/ppl/nextgen/submissions.
10 operations
8 paths
90 schemas
6 GET2 POST2 PUT
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 10
Across 8 paths, the API surfaces 10 operations — 6 GET, 2 POST, 2 PUT. They span 4 resource areas: health, version, negotiation, submission. Each is listed below with its method, path, parameters, and response codes.
health 1
GET
/health
Checks the health of this Submission Resource API.
version 1
GET
/version
Checks the version of this Submission Resource API.
negotiation 5
Enables the creation and management of the flow of negotiations from an Underwriter to a Broker. Negotiations shown will be those which (1) have been formally communicated to the…
GET
/submissions/{submissionId}/negotiations
Returns a list of all Negotiation records based upon various query parameters. Pagination functionality is supported on this operation.
POST
/submissions/{submissionId}/negotiations
Creates a single Negotiation record in response to a Broker User's request for consideration. Underwriter Users will be able to reject, confirm or negotiate on various attributes of their involvement…
GET
/submissions/{submissionId}/negotiations/{negotiationId}
Returns a single Negotiation record. This record will contain attributes pertaining to the single negotiation position between an Underwriter User and an Broker User, based upon its negotiation statu…
PUT
/submissions/{submissionId}/negotiations/{negotiationId}
Updates a Negotiation record, where the record is in a state that enables its update. For example, where Negotiations are in a saved and unsent state.
PUT
/submissions/{submissionId}/negotiations/{negotiationId}/reaassign
Reassigns a Negotiation record to another Underwriter User. The destined Underwriter User does not have to be a member of the same Carrier Team owning the original Submission, but must exist within t…
submission 3
Enables the retrieval of Submissions for Underwriters.
GET
/submissions
Returns a list of all Submission records based upon various query parameters. Pagination functionality is supported on this operation.
GET
/submissions/{submissionId}
Returns a single Submission record. This record includes structured data pertaining to a single Contract offering (and any subsequent Sections, if applicable) as well as references to download (1) th…
POST
/submissions/{submissionId}/send
Initiates the operation to send the latest Underwriter responses as part of a response to a Submission back to the Broker. The outcome of each Negotiation will either (1) agree unconditionally to the…
Schemas 90
The contract defines 90 schemas that model the data the API accepts and returns. The most detailed are submission_negotiation_getbyid (42 properties), submission_section_getbyid (27 properties), submission_negotiation_getall (26 properties), submission_negotiation_stamp (15 properties). Each schema is shown below with its type and property counts.
broker_team_only_name
object
The team information of the Broker Team responsible for the node.
1 property
1 required
broker_user
object
The User information of the responsible Broker User.
3 properties
3 required
comment_user
object
The User information of the User.
3 properties
3 required
metadata
object
A collection of data items to support the creation and update of record entities.
6 properties
6 required
metadata_user
object
The User information of the Metadata User.
3 properties
1 required
notification
object
The Notification information relating to the Document.
4 properties
4 required
response_submission_negotiations_getall
object
5 properties
5 required
sent_by_user
object
The User information of the User.
3 properties
3 required
submission_negotiation_amount
object
The specified underwriting value, as an amount.
2 properties
submission_negotiation_amount_postput
object
The specified underwriting value, as an amount.
2 properties
submission_negotiation_calculated
object
The calculated signing down information, following the Broker invoking the signing down process in the Section.
1 property
submission_negotiation_comments
object
Array of comments for Negotiation usage.
3 properties
3 required
submission_negotiation_contract_document
object
The negotiation pertaining to the content of the Contract Document.
2 properties
1 required
submission_negotiation_contract_document_postput
object
The negotiation pertaining to the content of the Contract Document.
2 properties
submission_negotiation_facility_panel
object
The Facility Panel information, holding values from the Master Facility as a whole. This information will be consistent across all Participation records which…
6 properties
2 required
submission_negotiation_facility_panel_calculated
object
The calculated signing down information, following the Broker invoking the signing down process in the Section.
1 property
submission_negotiation_facility_panel_master
object
4 properties
4 required
submission_negotiation_facility_panel_proposed
object
The proposed underwriting line information, that the Broker is proposing to the Underwriter.
3 properties
submission_negotiation_facility_panel_signed
object
The signed line information, that the Broker has confirmed to the Underwriter.
4 properties
submission_negotiation_facility_panel_written
object
The written underwriting line information, that the Underwriter is willing to accept.
4 properties
submission_negotiation_getall
object
Negotiation structure for Get All
26 properties
23 required
submission_negotiation_getbyid
object
Negotiation structure for Get by Identifier
42 properties
27 required
submission_negotiation_leader
object
6 properties
4 required
submission_negotiation_leader_stamp
object
8 properties
5 required
submission_negotiation_leader_written
object
3 properties
submission_negotiation_leader_written_amount
object
1 property
submission_negotiation_leader_written_line_percent
object
1 property
submission_negotiation_line_percentage
object
The specified underwriting value, as a percentage.
2 properties
submission_negotiation_line_percentage_postput
object
The specified underwriting value, as a percentage.
2 properties
submission_negotiation_post
object
Negotiation structure for creates
10 properties
2 required
submission_negotiation_proposed
object
The proposed underwriting line information, that the Broker is proposing to the Underwriter.
7 properties
submission_negotiation_put
object
Negotiation structure for updates
10 properties
2 required
submission_negotiation_reassign
object
Negotiation input structure for reassign
2 properties
2 required
submission_negotiation_reassign_output
object
Negotiation structure for reassign output
6 properties
6 required
submission_negotiation_role
object
A mapping between Participation and Participation Role Type. This allows multiple roles to be captured against a single participation, for example both Slip Le…
2 properties
2 required
submission_negotiation_role_plus
object
A mapping between Participation and Participation Role Type. This allows multiple roles to be captured against a single participation, for example both Slip Le…
3 properties
2 required
submission_negotiation_role_postput
object
A mapping between Participation and Participation Role Type. This allows multiple roles to be captured against a single participation, for example both Slip Le…
3 properties
2 required
submission_negotiation_save_response
object
Information about the saving of the Negotiation record.
2 properties
2 required
submission_negotiation_settlement
object
3 properties
3 required
submission_negotiation_signed
object
The signed line information, that the Broker has confirmed to the Underwriter.
4 properties
submission_negotiation_stamp
object
The Stamp information, identifying information about the underwriting entity, roles and line references to said underwriting.
15 properties
5 required
submission_negotiation_stamp_line_condition
object
The Line Condition information, identifying the Line Condition itself, the status of its agreement.
5 properties
4 required
submission_negotiation_stamp_line_condition_post
object
The Line Condition information, identifying the Line Condition itself, the status of its agreement.
3 properties
2 required
submission_negotiation_stamp_line_condition_put
object
The Line Condition information, identifying the Line Condition itself, the status of its agreement.
2 properties
1 required
submission_negotiation_stamp_post
object
The Stamp information, identifying information about the underwriting entity, roles and line references to said underwriting.
9 properties
1 required
submission_negotiation_stamp_put
object
The Stamp information, identifying information about the underwriting entity, roles and line references to said underwriting.
9 properties
1 required
submission_negotiation_stamp_reference
object
3 properties
2 required
submission_negotiation_stamp_risk_code
object
A collection of data items to represent the regulatory risk classification for a Contract or Section. Only supports Lloyds Agency Type Risk Codes.
2 properties
2 required
submission_negotiation_sub_panel
object
The sub panel information, identifying a group of Participations with a common set of underwriting terms.
2 properties
2 required
submission_negotiation_subjectivity
object
The Subjectivity information, identifying the Subjectivity itself, the status of cover prior to its agreement/satisfaction and any deadline applied to satisfy.
11 properties
8 required
submission_negotiation_subjectivity_post
object
The Subjectivity information, identifying the Subjectivity itself, the status of cover prior to its agreement/satisfaction and any deadline applied to satisfy.
6 properties
3 required
submission_negotiation_subjectivity_put
object
The Subjectivity information, identifying the Subjectivity itself, the status of cover prior to its agreement/satisfaction and any deadline applied to satisfy.
7 properties
4 required
submission_negotiation_written
object
The written underwriting line information, that the Underwriter is willing to accept.
5 properties
1 required
submission_negotiation_written_postput
object
The written underwriting line information, that the Underwriter is willing to accept.
3 properties
underwriter_team_no_org_no_company
object
The Team information of the Underwriter Team responsible for the Participation.
2 properties
2 required
underwriter_team_reassign
object
The Team information of the Underwriter Team responsible for the Participation.
1 property
1 required
underwriter_user
object
The User information of the Underwriter User responsible for the Participation.
3 properties
1 required
underwriter_user_reassign
object
The User information of the Underwriter User responsible for the Participation.
1 property
1 required
broker_team_company_no_id
object
The team information of the Broker Team responsible for the node.
2 properties
2 required
broker_team_org_company_no_id
object
The team information of the Broker Team responsible for the node.
3 properties
3 required
contract_insured
object
An individual or organisation, and their relationship within a contract of insurance.
2 properties
2 required
geographic_coverage
object
A collection of data items to represent the territory of cover for a Contract or Section.
3 properties
2 required
period
object
A collection of data items to denote the Contract or Section period.
2 properties
period_date
object
A collection of data items to denote the Contract or Section period using specific dates.
4 properties
2 required
period_range
object
A collection of data items to denote the Contract or Section period, as a numeric and unit of measurement.
2 properties
2 required
response_submissions_getall
object
5 properties
5 required
section_binding_information
object
The Binding Information relevant to a Contract or Section.
1 property
section_deductible
object
A collection of data items that represent the deductible(s) that are applied against the payment of a claim, within a Contract or Section.
6 properties
4 required
section_excess
object
A collection of data items that represents the Excess(es) applicable prior to any liability the insurer has agreed to cover under the terms of the insurance Co…
6 properties
4 required
section_limit
object
A collection of data items that represents the Limit(s) of any liability the insurer has agreed to cover under the terms of the insurance Contract or Section.
6 properties
4 required
section_premium
object
A collection of data items that represents the financial amount to cover the risk(s) under the terms of the insurance Contract or Section.
8 properties
2 required
section_risk
object
A collection of data items to represent the regulatory risk classification for a Contract or Section. Only supports Lloyds Agency Type Risk Codes.
2 properties
2 required
submission_contract_getall
object
A collection of insurance Contracts.
6 properties
6 required
submission_contract_getbyid
object
A collection of insurance Contracts.
14 properties
14 required
submission_contract_send
object
A collection of insurance Contracts.
8 properties
8 required
submission_getall
object
Submission structure for Get All
14 properties
14 required
submission_getbyid
object
Submission structure for Get by Identifier
14 properties
14 required
submission_programme_getall
object
A collection of Contracts for a common purpose.
4 properties
4 required
submission_programme_getbyid
object
A collection of Contracts for a common purpose.
4 properties
4 required
submission_programme_send
object
A collection of Contracts for a common purpose.
3 properties
3 required
submission_section_getall
object
A representation of a specific partition of the overall risk to be insured. A section can be based upon the cover type, coverage (e.g. class of business) and/o…
5 properties
5 required
submission_section_getbyid
object
A representation of a specific partition of the overall risk to be insured. A section can be based upon the cover type, coverage (e.g. class of business) and/o…
27 properties
14 required
submission_section_send
object
A representation of a specific partition of the overall risk to be insured. A section can be based upon the cover type, coverage (e.g. class of business) and/o…
4 properties
2 required
submission_send_input
object
Submission input structure for Send
1 property
1 required
submission_send_output
object
Submission output structure for Send
9 properties
9 required
underwriter_team_no_org
object
The Team information of the Underwriter Team responsible for the Participation.
3 properties
3 required
health
object
Health endpoint payload
1 property
version
object
Version endpoint payload
2 properties
error
object
4 properties
error_document
object
The error document.
1 property
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from PPL 4
Other APIs PPL publishes across the network.
PPL Placements API
PPL Organisations API
PPL Documents API
PPL Events API
#Submission#Negotiation#Quotes#Underwriting
Where this information came from
This is an independent, third-party profile of PPL Submissions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.