# Whitespace Risks API

**Canonical:** https://apis.io/apis/whitespace-london/whitespace-london-risks-api/  
**Provider:** Whitespace — https://apis.io/providers/whitespace-london/  
**Base URL:** https://sandbox.whitespace.co.uk/  
**Documentation:** https://apidocs.whitespace.co.uk/

Whitespace Risks API is one of 24 APIs that [Whitespace](https://apis.io/providers/whitespace-london/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Risks. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

The Risks API from Whitespace — 55 operation(s) for risks.

## Operations (55)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/risks/{riskID}` | Get a Risk in JMRC format |
| POST | `/api/risks/{riskID}/editLineItem` | Edits one line item in the risk |
| POST | `/api/risks/{riskID}/editMultipleLineItems` | Edits multiple line items at the same time on a risk |
| POST | `/api/risks/{riskID}/changeDraftNowQuoteInPreparation` | The Underwriter takes a Quotation Request and starts preparing an Underwriter Quotation - Underwriter Only |
| POST | `/api/risks/{riskID}/cloneDraft` | Clones an existing risk as a new draft, setting UMR and Insured - Broker Only |
| POST | `/api/risks/{riskID}/declineQuoteRequest` | Called by the Underwriter to decline a quote request - Underwriter Only |
| POST | `/api/risks/{riskID}/draftToFirmOrder` | Creates a firm order risk from a draft - Broker Only |
| GET | `/api/risks/{riskID}/endorsementFollowers` | Details of the follower carriers on an endorsement |
| GET | `/api/risks/{riskID}/getExtendedMRC` | get extended data about the state of a risk, adding, for instance, written and signed lines to the risk itself |
| GET | `/api/risks/{riskID}/lineitem/{mrcHeading}` | Gets the line item by index, or all line items for a specified heading |
| POST | `/api/risks/{riskID}/markAsFirmOrder` | The broker converts a quoted risk into a firm order - Broker Only |
| POST | `/api/risks/{riskID}/markAsIndicative` | The underwriter sets or unsets the indicative flag for an Underwriter Quotation ::UQx |
| POST | `/api/risks/{riskID}/requestWrittenLineSets` | Sends a Firm Order/Bindable Quote risk to a carrier for a Written Line - Broker Only |
| POST | `/api/risks/{riskID}/showQuoteToBroker` | The Underwriter sends an Underwriter Quotation back to the Broker - Underwriter Only |
| POST | `/api/risks/{riskID}/showToLeadUnderwriter` | Shows a draft risk to an underwriter for quoting - Broker Only |
| POST | `/api/risks/{riskID}/signSets` | Sign the written lines on a Firm Order, promoting the risk to signed status - Broker Only |
| POST | `/api/risks/{riskID}/reSignSets` | Update the Signed Lines on a Signed Risk - Broker Only |
| POST | `/api/risks/{riskID}/writeLine` | Writes a line to the risk - Underwriter Only |
| POST | `/api/risks/newDraft` | Creates a draft risk using a simplified input format - Broker Only |
| GET | `/api/risks/root/{rootID}` | Get a list of documents associated with a risk |
| GET | `/api/risks/{rootID}/related/{type}` | returns documents of a certain type for a risk |
| POST | `/api/risks/save` | Create a new risk from a full JMRC - Broker Only |
| POST | `/api/risks/{EndorsementID}/showEndorsement` | Show an endorsement to underwriters - Broker Only |
| POST | `/api/risks/{EndorsementID}/acceptEndorsement` | Accept an endorsement as an underwriter - Underwriter Only |
| POST | `/api/risks/changeRiskName/{rootID}` | Change the name of the risk - Broker Only |
| POST | `/api/risks/{quoteID}/createDraftFromQuote` | Create an editable draft from a quote - Broker Only |
| POST | `/api/risks/{riskID}/lineItemAttributes` | Edit an attribute of a line item -- that is, one contract heading and its associated text -- such as locking the text to prevent further editing, or adding a... |
| GET | `/api/risks/{riskID}/getQuoteDetails` | Returns any information entered by the underwriter into a quote's 'Quote Details' panel. Underwriters are not required to use this panel when quoting, so som... |
| POST | `/api/risks/{riskID}/saveQuoteDetails` | Edit and Save Quote Details - Underwriter Only |
| POST | `/api/risks/{riskID}/createBindableQuote` | Creates a Bindable Quote - Broker Only |
| POST | `/api/risks/{riskID}/selfApproveSecondApproval` | Self-approve one of your contracts flagged for internal review. NOTE You must have the 'Self Approver' role enabled for this API call to work. |
| POST | `/api/risks/{riskID}/duplicateDraft` | Duplicate an existing draft contract under the same risk overview - Broker Only |
| POST | `/api/risks/{riskID}/changeHeadings` | Delete contract headings from a risk. |
| POST | `/api/risks/{riskID}/declineFirmOrder` | Declines a firm order - Underwriter Only |
| POST | `/api/risks/{riskID}/withdrawFirmOrder` | Withdraw a firm order from an underwriter - Broker Only |
| POST | `/api/risks/{riskID}/saveVerticalLines` | Sets the vertical terms for a specific heading on a risk. This operation can only be performed on contracts at the firm order or bindable quote stages - Brok... |
| POST | `/api/risks/{riskID}/notTakeUpQuotation` | Mark a quote recieved from an underwriter as NTU (Not Taken Up) - Broker Only |
| POST | `/api/risks/{riskID}/rollbackSigned` | Reverts a risk from signed to unsigned - Broker Only |
| POST | `/api/risks/{riskID}/createEndorsement` | Creates an endorsement - Broker Only |
| POST | `/api/risks/{riskID}/deleteDraft` | Deletes a Draft Contract - Broker Only |
| POST | `/api/risks/{riskID}/applyTemplate` | Merge the data from a risk with the text, data and other material from a template, preserving all the risk''s data while replacing all its other content - Br... |
| POST | `/api/risks/{riskID}/rejectWrittenLine/{writtenLineSetID}` | Reject an underwriter''s line written with Line Conditions or Subjectivities - Broker Only |
| POST | `/api/risks/{riskID}/acceptWrittenLine/{writtenLineSetID}` | Accepts an underwriter''s line with Line Conditions or Subjectivities - Broker Only |
| POST | `/api/risks/{riskID}/createContractCorrection` | Create a Contract Correction - Broker Only |
| POST | `/api/risks/{riskID}/contractAttributes` | Edit an attribute of the entire contract. Currently limited to text-locking options - Broker Only |
| POST | `/api/risks/{riskID}/setTemplateChannels` | Set the teams that a template is visible to - Broker Only |
| POST | `/api/risks/{riskID}/quoteOnRequest` | Send a Quote back to the broker wihout making any alterations to the Quote Request received - Underwriter only |
| POST | `/api/risks/{riskID}/deleteEndorsement` | Deletes a Draft Endorsement - Broker Only |
| POST | `/bodapi/risks/from` | Create a new risk/template using the Contract Library |
| POST | `/api/risks/{riskID}/editLineItemWithBB` | Add or edit a heading in a risk using a lineitem from the Clause Library |
| POST | `/api/risks/{riskID}/recordLine` | Record an off-platform line - Broker Only |
| POST | `/api/risks/{riskID}/forwardAsQuoteRequest` | Forwards a quote as a new quote request - Broker Only |
| POST | `/api/risks/{riskID}/setEndorsementFollowerRoles` | Set the roles of carriers on a Endorsement - Broker Only |
| POST | `/api/risks/{riskID}/setEndorsementFollowerTemplate` | Set the agreement template for an endorsement - Broker Only |
| POST | `/api/risks/{riskID}/completeEndorsement` | Complete a Endorsement and bind any notify parties to it - Broker Only |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/whitespace-london/refs/heads/main/openapi/whitespace-london-risks-api-openapi.yml
- **APIReference** — https://swagger.whitespace.co.uk/
- **Documentation** — https://apidocs.whitespace.co.uk/
- **Documentation** — https://apidocs.whitespace.co.uk/Getting_Started_with_the_Whitespace_API.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/Obtaining_and_Using_a_Service_Token_for_the_API.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/Refresh_Token_Guide_v1.0.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/How_does_API_versioning_work.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/An_Introduction_to_Defined_Data.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/Defined%20Data%20API%20and%20JSON%20Notes.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/JMRC%20ACORD%20Specification%20V0.5%20-%20Defined%20Data.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/Queues_and_the_Whitespace_Platform_v1.2.2.pdf
- **Documentation** — https://apidocs.whitespace.co.uk/Integrating_with_Whitespace_via_Queues_3.1.pdf

## Other Whitespace APIs (12)

- [Whitespace Activities API](https://apis.io/apis/whitespace-london/whitespace-london-activities-api/)
- [Whitespace Attachments API](https://apis.io/apis/whitespace-london/whitespace-london-attachments-api/)
- [Whitespace Bind Notify Parties API](https://apis.io/apis/whitespace-london/whitespace-london-bind-notify-parties-api/)
- [Whitespace Comments API](https://apis.io/apis/whitespace-london/whitespace-london-comments-api/)
- [Whitespace Customer API](https://apis.io/apis/whitespace-london/whitespace-london-customer-api/)
- [Whitespace Data API](https://apis.io/apis/whitespace-london/whitespace-london-data-api/)
- [Whitespace Documents API](https://apis.io/apis/whitespace-london/whitespace-london-documents-api/)
- [Whitespace Endorsements API](https://apis.io/apis/whitespace-london/whitespace-london-endorsements-api/)
- [Whitespace Export API](https://apis.io/apis/whitespace-london/whitespace-london-export-api/)
- [Whitespace Internal Broker Note API](https://apis.io/apis/whitespace-london/whitespace-london-internal-broker-note-api/)
- [Whitespace Labels API](https://apis.io/apis/whitespace-london/whitespace-london-labels-api/)
- [Whitespace Lines API](https://apis.io/apis/whitespace-london/whitespace-london-lines-api/)

## Tags

Risks

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/whitespace-london/whitespace-london-risks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/whitespace-london/.