How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

PPL Contract API

Enables the creation and management of Contract structured data.

PPL Contract API is one of 13 APIs that PPL publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contract. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 3 paths, and defines 31 schemas. It is described by OpenAPI 3.2.0, at version 1.

Requests are made against a single base URL, https://sand-api.londonmarketgroup.co.uk/ppl/nextgen/placements.

6 operations 3 paths 31 schemas 1 DELETE2 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1
Base URL
https://api.londonmarketgroup.co.uk/ppl/nextgen/placements/v1
Resource Areas
1

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

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.
Contract_GetAll_v1 23 params → 200400401404414429500
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…
Contract_Post_v1 2 params body → 200400401404414429500
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…
Contract_GetById_v1 3 params → 200400401404414429500
PUT
/contracts/{contractId}
Updates the Contract record. This will also update the "default" Section of information.
Contract_Put_v1 4 params body → 200400401404414429500
DELETE
/contracts/{contractId}
Deletes a Contract record, where the record is in a state that enables its deletion.
Contract_Delete_v1 3 params → 200400401404414429500
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…
Contract_AssignRoles_v1 3 params body → 200400401404414429500

Schemas 31

The contract defines 31 schemas that model the data the API accepts and returns. The most detailed are contract_getbyid (25 properties), contract_default_section_getbyid (23 properties), contract_default_section_postput (19 properties), contract_getall (17 properties). Each schema is shown below with its type and property counts.

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
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_post
object
Contract structure for creates
10 properties 6 required
period_date
object
A collection of data items to denote the Contract or Section period using specific dates.
4 properties 2 required
section_binding_information
object
The Binding Information relevant to a Contract or Section.
1 property
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
contract_getbyid
object
Contract for Get By Id
25 properties 18 required
contract_getall
object
Contract for Get All
17 properties 17 required
notification
object
The Notification information relating to the Document.
4 properties 4 required
geographic_coverage
object
A collection of data items to represent the territory of cover for a Contract or Section.
3 properties 2 required
contract_assignroles_output
object
Contract output structure for assign roles
4 properties 3 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
metadata_user
object
The User information of the Metadata User.
3 properties 1 required
broker_user
object
The User information of the responsible Broker User.
3 properties 3 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
period
object
A collection of data items to denote the Contract or Section period.
2 properties
contract_insured
object
An individual or organisation, and their relationship within a contract of insurance.
2 properties 2 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
contract_put
object
Contract structure for updates
11 properties 7 required
period_getall
object
A collection of data items to denote the Contract or Section period.
2 properties
response_contracts_getall
object
5 properties
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_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
metadata
object
A collection of data items to support the creation and update of record entities.
6 properties 6 required
error
object
4 properties
error_document
object
The error document.
1 property
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
broker_team_company
object
The team information of the Broker Team responsible for the node.
3 properties 3 required
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
contract_assignroles
object
Contract input structure for assign roles
1 property
period_date_getall
object
A collection of data items to denote the Contract or Section period using specific dates.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ppl-london-market-contract-api-openapi.yml Raw ↑

Other APIs PPL publishes across the network.

PPL Document API
PPL Health API
PPL Negotiation API
PPL Notification API
PPL Organisation API
PPL Participation API
PPL Placement API
PPL Programme API
PPL Section API
PPL Submission API
PPL Transaction API
PPL Version API
Where this information came from

This is an independent, third-party profile of PPL Contract 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.