PPL Placements API
Manages the Placement structure in PPL Next Gen - Placements, Programmes, Contracts and the Sections within a Contract - together with carrier and underwriter participations, role assignment, and the broker-side negotiation of terms. This is the bind-side surface of the platform. OpenAPI 3.0.1, 16 paths and 32 operations.
PPL Placements API is one of 5 APIs that PPL publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Placement, Contract, Negotiation, Participation, and Bind. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 32 operations across 16 paths, organized into 8 resource areas, and defines 128 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/placements.
32 operations
16 paths
128 schemas
5 DELETE13 GET8 POST6 PUT
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 32
Across 16 paths, the API surfaces 32 operations — 5 DELETE, 13 GET, 8 POST, 6 PUT. They span 8 resource areas: health, placement, version, programme, contract, section, participation, negotiation. Each is listed below with its method, path, parameters, and response codes.
health 1
GET
/health
Checks the health of this Placement Resource API.
placement 5
Enables the creation and management of the Placement structure that comprises of Programmes and Contracts.
GET
/placements
Returns a list of Placement records and any Programme structures, based upon various query parameters. This end point will also provide minimal information about any Contracts within the Placement st…
POST
/placements
Creates a Placement record. This is the starting point in order for Contracts and Programmes to be added into the platform.
GET
/placements/{placementId}
Returns the Placement structure for a specified Placement record. This will contains information about the Placement, its Programmes and summarised information about Contract records within the Place…
PUT
/placements/{placementId}
Updates a Placement record, where the record is in a state that enables its update.
DELETE
/placements/{placementId}
Deletes a Placement record, where the record is in a state that enables its deletion.
version 1
GET
/version
Checks the version of this Placement Resource API.
programme 4
Enables the creation and management of Programme structures within a Placement. This also includes the capability to add existing Contracts into a programme.
POST
/placements/{placementId}/programmes
Creates a Programme record under the Placement structure. This enables the grouping of Contract records that address a common insurance purpose. Contracts can be added at the time of creation.
GET
/placements/{placementId}/programmes/{programmeId}
Returns the Programme structure for a specified Programme record. This will return information about the Programme and summarised information about Contract records within the Programme structure.
PUT
/placements/{placementId}/programmes/{programmeId}
Updates a Programme record. Contracts can be added into the Programme structure.
DELETE
/placements/{placementId}/programmes/{programmeId}
Deletes a Programme record, where the record is in a state that enables its deletion. Any Contract records that exist in this Programme will be moved into the default Programme.
contract 6
Enables the creation and management of Contract structured data.
GET
/contracts
Returns a list of Contract records, based upon various query parameters. Pagination functionality is supported on this operation.
POST
/contracts
Creates a Contract record under the Placement structure. This will also create the "default" Section of information, which is necessary for adding Underwriters and Facility markets for underwriting p…
GET
/contracts/{contractId}
Returns a single Contract record. This record will contain core Contract information, that includes data attributes that summarise information about the risk to be insured, as well as a summarised li…
PUT
/contracts/{contractId}
Updates the Contract record. This will also update the "default" Section of information.
DELETE
/contracts/{contractId}
Deletes a Contract record, where the record is in a state that enables its deletion.
POST
/contracts/{contractId}/assignRoles
Initiates the asynchronous operation to assign the contractual roles to Participations and their Stamps on the Contract. Where a specific Slip Leader has been identified, the process will take this i…
section 5
Enables the creation and management of Contract sections, as structured data. Each Section represents of a specific partition of the overall risk to be insured. A section can be b…
GET
/contracts/{contractId}/sections
Returns a list of Section records, within a single Contract record. This returned list is a subset of all Section record fields, based upon various query parameters.
POST
/contracts/{contractId}/sections
Creates a Section record under the Contract, representing a specific partition of the overall risk and / or coverage to be insured.
GET
/contracts/{contractId}/sections/{sectionId}
Returns a single Section record. This record will contain all the Section-related structured data.
PUT
/contracts/{contractId}/sections/{sectionId}
Updates a Section record, where the record is in a state that enables its update.
DELETE
/contracts/{contractId}/sections/{sectionId}
Deletes a Section record, where the record is in a state that enables its deletion.
participation 5
Enables the creation, management and processing of Open Market Underwriters and Facility Panel Underwriters that are willing to participate in the underwriting of an insured's ass…
GET
/contracts/{contractId}/sections/{sectionId}/participations
Returns a list of Participation records, within a single Section. This returned list is based upon various query parameters. Pagination functionality is supported on this operation.
POST
/contracts/{contractId}/sections/{sectionId}/participations
Creates Participation records representing either a single Open Market Underwriter and the Carrier Stamps they are permitted to use, or a multiple of Participation records representing each Underwrit…
GET
/contracts/{contractId}/sections/{sectionId}/participations/{participationId}
Returns a single Participation record. This record will contain the underwriter attributes for underwriting a risk, as well as any facility panel information, where the Underwriter's involvement is m…
PUT
/contracts/{contractId}/sections/{sectionId}/participations/{participationId}
Updates a Participation record, where the record is in a state that enables its update. Where an Underwriter update involves an update upon a Facility Panel, all involved Participations of said Facil…
DELETE
/contracts/{contractId}/sections/{sectionId}/participations/{participationId}
Deletes a Participation record, where the record is in a state that enables its deletion.
negotiation 5
Enables the creation and management of the flow of negotiations from a Broker to an Underwriter. Negotiations shown will be those which (1) have been formally communicated to the…
GET
/contracts/{contractId}/negotiations
Returns a list of all Negotiation records based upon various query parameters. Pagination functionality is supported on this operation.
POST
/contracts/{contractId}/negotiations
Creates a single Negotiation record in response to an Underwriter User's response. Broker Users will be able to accept or reject, confirm or negotiate on various attributes of their involvement, i.e.…
GET
/contracts/{contractId}/negotiations/{negotiationId}
Returns a single Negotiation record. This record will contain attributes pertaining to the single negotiation position between a Broker User and an Underwriter User, based upon its negotiation status…
PUT
/contracts/{contractId}/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.
POST
/contracts/{contractId}/negotiations/{negotiationId}/send
Initiates the operation to send the latest negotiation response back to an Underwriter. The outcome of this will either (1) agree to the change of terms; (2) negotiate the Underwriter's latest offer;…
Schemas 128
The contract defines 128 schemas that model the data the API accepts and returns. The most detailed are placement_negotiation_getbyid (42 properties), section_getbyid (32 properties), participation_getbyid (30 properties), placement_negotiation_getall (26 properties). Each schema is shown below with its type and property counts.
broker_team_org_company
object
The team information of the Broker Team responsible for the node.
4 properties
4 required
calculated
object
The calculated signing down information, following the Broker invoking the signing down process in the Section.
1 property
1 required
facility_panel_get
object
The Facility Panel information, holding values from the Master Facility as a whole. This information will be consistent across all Participation records which…
4 properties
4 required
facility_panel_post
object
The Facility Panel information, holding values from the Master Facility as a whole. This information will be consistent across all Participation records which…
3 properties
2 required
facility_panel_put
object
The Facility Panel information, holding values from the Master Facility as a whole. This information will be consistent across all Participation records which…
3 properties
3 required
facility_roles
object
The facility role information that the Declaration Underwriter takes part in through their Participation.
2 properties
2 required
line_condition_get
object
The Line Condition information, identifying the Line Condition itself, the status of its agreement.
4 properties
4 required
master_facility_get
object
The Master Facility information, holding original master facility information.
3 properties
3 required
participation_getbyid
object
Participation information
30 properties
13 required
participation_post
object
Participation structure for creates
5 properties
participation_put
object
Participation structure for updates
7 properties
participation_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
proposed
object
The proposed underwriting line information, that the Broker is proposing to the Underwriter.
7 properties
proposed_panel
object
The proposed underwriting line information, that the Broker is proposing to the Underwriter for this facility.
3 properties
reference_get
object
The line reference information, which captures the line references in relating to the Contract or Section that is being underwritten. Also maintain the Risk Cl…
3 properties
1 required
response_participations_getall
object
5 properties
5 required
response_participations_getall_post
object
2 properties
2 required
signed
object
The signed line information, that the Broker has confirmed to the Underwriter.
2 properties
2 required
signed_facility
object
The signed line information, that the Broker has confirmed to the Underwriter, from the original master facility participation.
1 property
stamp_get
object
The Stamp information, identifying information about the underwriting entity, roles and line references to said underwriting.
13 properties
5 required
stamp_postput
object
The Stamp information, identifying information about the underwriting entity, roles and line references to said underwriting.
1 property
1 required
sub_panel_get
object
The sub panel information, identifying a group of Participations with a common set of underwriting terms.
3 properties
3 required
sub_panel_postput
object
The sub panel information, identifying a group of Participations with a common set of underwriting terms.
1 property
1 required
subjectivity_get
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
5 required
team_user
object
The User information of the User.
3 properties
1 required
underwriter_team
object
The Team information of the Underwriter Team responsible for the Participation.
4 properties
4 required
underwriter_user_participation
object
The User information of the Underwriter User responsible for the Participation.
4 properties
1 required
written
object
The written underwriting line information, that the Underwriter is willing to accept.
5 properties
1 required
written_facility
object
The written underwriting line information, that the Underwriter is willing to accept, from the original master facility participation.
3 properties
broker_team_company
object
The team information of the Broker Team responsible for the node.
3 properties
3 required
broker_user
object
The User information of the responsible Broker User.
3 properties
3 required
health
object
Health endpoint payload
1 property
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
contract_default_section_getall
object
The default section of the contract represents the summary of the overall risk to be insured under the Contract.
5 properties
2 required
placement_broker_team
object
The team information of the Broker Team responsible for the Placement.
4 properties
placement_contract_getbyid
object
A collection of insurance Contracts.
15 properties
3 required
placement_getall
object
Placement for Get All
11 properties
5 required
placement_getbyid
object
Placement for Get By Id
11 properties
5 required
placement_programme_getall
object
A collection of Contracts for a common purpose.
4 properties
1 required
placement_post
object
Placement structure for creates
4 properties
4 required
placement_programme_getbyid
object
A collection of Contracts for a common purpose.
10 properties
2 required
placement_put
object
Placement structure for updates
4 properties
4 required
placement_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…
5 properties
1 required
version
object
Version endpoint payload
2 properties
programme_contract_getbyid
object
A collection of insurance Contracts.
2 properties
2 required
programme_contract_postput
object
1 property
1 required
programme_getbyid
object
A collection of Contracts for a common purpose.
11 properties
10 required
programme_put
object
Programme structure for updates
3 properties
2 required
programme_post
object
Programme structure for creates
3 properties
2 required
response_contracts_getall
object
5 properties
response_placements_getall
object
5 properties
response_sections_getall
object
5 properties
contract_default_section_getbyid
object
The default section of the contract represents the summary of the overall risk to be insured under the Contract.
23 properties
3 required
contract_default_section_postput
object
The default section of the contract represents the summary of the overall risk to be insured under the Contract.
19 properties
2 required
contract_getall
object
Contract for Get All
17 properties
17 required
contract_getbyid
object
Contract for Get By Id
25 properties
18 required
contract_insured
object
An individual or organisation, and their relationship within a contract of insurance.
2 properties
2 required
contract_put
object
Contract structure for updates
11 properties
7 required
contract_post
object
Contract structure for creates
10 properties
6 required
contract_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…
5 properties
1 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_date_getall
object
A collection of data items to denote the Contract or Section period using specific dates.
2 properties
2 required
period_getall
object
A collection of data items to denote the Contract or Section period.
2 properties
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
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
section_getall
object
The default section of the contract represents the summary of the overall risk to be insured under the Contract.
20 properties
11 required
section_getbyid
object
The default section of the contract represents the summary of the overall risk to be insured under the Contract.
32 properties
12 required
section_postput
object
Section structure for creates and updates
21 properties
4 required
broker_team
object
The team information of the Broker Team responsible for the node.
2 properties
2 required
comment_user
object
The User information of the User.
3 properties
3 required
placement_negotiation_amount
object
The specified underwriting value, as an amount.
2 properties
placement_negotiation_amount_postput
object
The specified underwriting value, as an amount.
1 property
placement_negotiation_calculated
object
The calculated signing down information, following the Broker invoking the signing down process in the Section.
1 property
placement_negotiation_comments
object
Array of comments for Negotiation usage.
3 properties
3 required
placement_negotiation_contract_document
object
The negotiation pertaining to the content of the Contract Document.
2 properties
1 required
placement_negotiation_contract_document_postput
object
The negotiation pertaining to the content of the Contract Document.
2 properties
placement_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
placement_negotiation_facility_panel_calculated
object
The calculated signing down information, following the Broker invoking the signing down process in the Section.
1 property
placement_negotiation_facility_panel_master
object
4 properties
4 required
placement_negotiation_facility_panel_proposed
object
The proposed underwriting line information, that the Broker is proposing to the Underwriter.
3 properties
placement_negotiation_facility_panel_signed
object
The signed line information, that the Broker has confirmed to the Underwriter.
4 properties
placement_negotiation_facility_panel_written
object
The written underwriting line information, that the Underwriter is willing to accept.
4 properties
placement_negotiation_getall
object
Negotiation structure for Get All
26 properties
23 required
placement_negotiation_getbyid
object
Negotiation structure for Get by Identifier
42 properties
27 required
placement_negotiation_leader
object
6 properties
4 required
placement_negotiation_leader_stamp
object
8 properties
5 required
placement_negotiation_leader_written
object
3 properties
placement_negotiation_leader_written_amount
object
1 property
placement_negotiation_leader_written_line_percenta
object
1 property
placement_negotiation_line_percentage
object
The specified underwriting value, as a percentage.
2 properties
placement_negotiation_line_percentage_postput
object
The specified underwriting value, as a percentage.
1 property
placement_negotiation_post
object
Negotiation structure for creates
8 properties
2 required
placement_negotiation_proposed
object
The proposed underwriting line information, that the Broker is proposing to the Underwriter.
7 properties
placement_negotiation_put
object
Negotiation structure for updates
8 properties
2 required
placement_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
placement_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
placement_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
placement_negotiation_save_response
object
Information about the saving of the Negotiation record.
2 properties
2 required
placement_negotiation_settlement
object
3 properties
3 required
placement_negotiation_signed
object
The signed line information, that the Broker has confirmed to the Underwriter.
4 properties
placement_negotiation_stamp
object
The Stamp information, identifying information about the underwriting entity, roles and line references to said underwriting.
16 properties
5 required
placement_negotiation_stamp_line_condition
object
The Line Condition information, identifying the Line Condition itself, the status of its agreement.
5 properties
4 required
placement_negotiation_stamp_line_condition_postput
object
The Line Condition information, identifying the Line Condition itself, the status of its agreement.
3 properties
2 required
placement_negotiation_stamp_postput
object
The Stamp information, identifying information about the underwriting entity, roles and line references to said underwriting.
4 properties
2 required
placement_negotiation_stamp_reference
object
3 properties
2 required
placement_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
placement_negotiation_sub_panel
object
The sub panel information, identifying a group of Participations with a common set of underwriting terms.
2 properties
2 required
placement_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
placement_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.
3 properties
1 required
placement_negotiation_written
object
The written underwriting line information, that the Underwriter is willing to accept.
5 properties
1 required
placement_negotiation_written_postput
object
The written underwriting line information, that the Underwriter is willing to accept.
3 properties
1 required
response_placement_negotiations_getall
object
5 properties
5 required
sent_by_user
object
The User information of the User.
3 properties
3 required
underwriter_team_only_name
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
contract_assignroles
object
Contract input structure for assign roles
1 property
contract_assignroles_output
object
Contract output structure for assign roles
4 properties
3 required
notification
object
The Notification information relating to the Document.
4 properties
4 required
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 Submissions API
PPL Organisations API
PPL Documents API
PPL Events API
#Placement#Contract#Negotiation#Participation#Bind
Where this information came from
This is an independent, third-party profile of PPL Placements 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.