Beazley

Beazley Risks API

The Risks API from Beazley — 2 operation(s) for risks.

Documentation GitHub OpenAPI

Operations 3

GET /risks/{id} risk #

PUT /risks/{id} update risk #

POST /risks/ create risk #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/beazley-risks-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: 'Data Capture: Quote and Risk Data v2 (Sandbox) Risks API'
  description: 'A sandbox version of version 2 of the Data Capture API. This API provides a channel for partner systems to feed quote and risk data directly into Beazley''s core Record of Risk systems. The current published version of this API is V1.


    Please contact

    ITArchitecture@Beazley.com if you have any questions about this API.'
  version: '1.0'
servers:
- url: https://api.beazley.com/sandbox/riskcapture/v2
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Risks
paths:
  /risks/{id}:
    get:
      summary: risk
      operationId: 5538d88d97fe1e0ff06f4248
      parameters:
      - name: id
        in: path
        description: ''
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
      tags:
      - Risks
    put:
      summary: update risk
      description: Use the PUT method to update existing records. Note that the full risk object is required and any fields that are passed must have a value - blanks values will replace existing data with a empty string.
      operationId: 5538d88d97fe1e0ff06f424a
      parameters:
      - name: id
        in: path
        description: ''
        required: true
        schema:
          type: string
      requestBody:
        description: ''
        content:
          application/json:
            example:
              RiskId: 6a491ef4-36b8-4157-842c-ecac4cb936fa
              TransactionDateTimeUTC: '2015-06-09T12:00:00.0000000+00:00'
              TransactionSequenceId: 1
              TransactionType: Create
              SourceSystem: myBeazley
              RiskUniqueId: 606ab36d-292a-4ebd-9357-f6ec598c240c
              RiskReference: ABC1234
              OriginalId: null
              RiskStatus: Quoted
              CancellationReasonId: null
              PolicyHolderIndividual: null
              Turnover: null
              Employees: null
              CancellationDate: null
              ProductId: PI UK
              BzyRiskReference: BZY65479321
              Underwriter: Tom Jones
              AnnualisedGrossPremium: 31750
              PrimaryCurrency: USD
              BenchmarkPricingIndicator: 0.8
              Parties:
              - Type: PrimaryInsured
                CustomerId: null
                Name: Rook Industries
                Parent: null
                PrimarySector: Industrial Technology & Research
                TechSector: true
                PrimaryContact: Sebastian Rooks
                PrimaryContactEmail: sebastian@rook.com
                PrimaryContactPhone: (140)-640-8191
                PrimaryAddress:
                  CityTown: Cambridge
                  Country: USA
                  FloorOrSuite: '2'
                  Line1: 77 Massachusetts Avenue
                  Line2: Building A
                  Line3: null
                  StateCountyProvince: MA
                  PostZipCode: 02139
              - Type: PlacingBroker
                CustomerId: null
                Name: Joseph & Joseph, London UK
                Parent: Joseph & Joseph
                PrimarySector: null
                TechSector: false
                PrimaryContact: Sam Spade
                PrimaryContactEmail: sam.spade@jj.com
                PrimaryContactPhone: (140)-555-5555
                PrimaryAddress:
                  CityTown: London
                  Country: GBR
                  FloorOrSuite: ''
                  Line1: null
                  Line2: null
                  Line3: null
                  StateCountyProvince: null
                  PostZipCode: null
              - Type: ProducingBroker
                CustomerId: null
                Name: Nimlane, Boston MA
                Parent: Nimlane USA
                PrimarySector: null
                TechSector: false
                PrimaryContact: Tiffany Harrison
                PrimaryContactEmail: tharrison@nimlane.com
                PrimaryContactPhone: (916)-975-8644
                PrimaryAddress:
                  CityTown: Boston
                  Country: USA
                  FloorOrSuite: null
                  Line1: null
                  Line2: null
                  Line3: null
                  StateCountyProvince: MA
                  PostZipCode: null
              Sections:
              - SectionUniqueId: null
                SectionReference: '001'
                SectionSequenceID: 1
                CoverageName: Buildings
                CreationDate: '2014-10-20T00:00:00.0000000+00:00'
                BindDate: '2014-10-20T00:00:00.0000000+00:00'
                InceptionDate: '2014-11-20T00:00:00.0000000+00:00'
                ExpiryDate: '2015-11-20T00:00:00.0000000+00:00'
                RetroactiveDate: '2010-10-20T00:00:00.0000000+00:00'
                EndorsementEffectiveDateFrom: null
                EndorsementEffectiveDateTo: null
                SectionStatus: Quoted
                Currency: USD
                GrossPremium: 1111111.99
                NetPremium: null
                Commissions:
                - Type: PlacingBroker
                  Rate: 0.03
                  TaxableAmount: 25000
                  Amount: 750
                - Type: ProducingBroker
                  Rate: 0.03
                  TaxableAmount: 25000
                  Amount: 750
                Taxes:
                - Type: State fire tax
                  Rate: 0.07
                  TaxableAmount: 25000
                  Amount: 1750
                - Type: GST
                  Rate: 0.2
                  TaxableAmount: 25000
                  Amount: 5000
                Limits:
                - Type: Limit per Claim, expenses in addition
                  Amount: 100000
                - Type: Limit per Claim, expenses in addition
                  Amount: 25000
                Assets:
                - Locations:
                  - AssetId: null
                    AssetName: Example location
                    CityTown: Cambridge
                    Country: USA
                    FloorOrSuite: '2'
                    Line1: 77 Massachusetts Avenue
                    Line2: Building A
                    Line3: null
                    StateCountyProvince: MA
                    PostZipCode: 02139
                  - AssetId: null
                    AssetName: Another example location
                    CityTown: Exeter
                    Country: UK
                    FloorOrSuite: ''
                    Line1: 1 Street
                    Line2: null
                    Line3: null
                    StateCountyProvince: Devon
                    PostZipCode: EX1 1DB
                  Insureds:
                  - AssetId: null
                    AssetName: Example insured
                    Parent: null
                    PrimarySector: Industrial Technology & Research
                    TechSector: true
                    Revenue: 20000000
                    RevenueCurrency: USD
                    PrimaryContact: Sebastian Rooks
                    PrimaryContactEmail: sebastian@rook.com
                    PrimaryContactPhone: (140)-640-8191
                    PrimaryAddress:
                      CityTown: Cambridge
                      Country: USA
                      FloorOrSuite: '2'
                      Line1: 77 Massachusetts Avenue
                      Line2: Building A
                      Line3: null
                      StateCountyProvince: MA
                      PostZipCode: 02139
              Installments:
              - PaymentType: Unknown
                PaymentCurrency: USD
                PaymentDueDate: '2014-10-25T00:00:00.0000000+00:00'
                GrossPremiumAmount: 2645.99
                CommissionPercentage: 0.03
                CommissionAmount: 100.99
                NetPremium: 100000.99
                TaxandFeesPremium: 1000.99
                FinalTotal: 1000000.99
      responses:
        '400':
          description: ''
        '201':
          description: ''
          content:
            application/json:
              example:
                Id: b767637a-9af9-446b-9622-55679fbaf543
                Parties:
                - Id: 1f4bf203-3eb2-4e0e-848e-f732f9d8d504
                  Type: PrimaryInsured
                - Id: bc6a918a-f664-4caf-ba62-a8c1e7e6817f
                  Type: PlacingBroker
                - Id: 3ecdf700-619b-4e01-8dbf-925119772b8b
                  Type: ProducingBroker
                Sections:
                - Id: 5db926b6-f1d5-4240-90a4-dd300946ac59
                  SectionReference: '001'
                  Assets:
                  - Insureds:
                    - Id: 4ba44ae1-a6fe-411b-aec8-2fd0dcbd6eb5
                      AssetName: Example insured
                    Locations:
                    - Id: bcbaf1b4-132c-4bee-96ad-11cbc944f45d
                      AssetName: Example location
                    - Id: 9d4901b6-265d-4fed-bc55-20cc6499fe7f
                      AssetName: Another example location
        '422':
          description: ''
      tags:
      - Risks
  /risks/:
    post:
      summary: create risk
      description: Use the POST method to create a new record.
      operationId: 5538d88d97fe1e0ff06f4249
      requestBody:
        description: ''
        content:
          application/json:
            example:
              RiskId: null
              TransactionDateTimeUTC: '2015-06-09T12:00:00.0000000+00:00'
              TransactionSequenceId: 1
              TransactionType: Create
              SourceSystem: myBeazley
              RiskUniqueId: 606ab36d-292a-4ebd-9357-f6ec598c240c
              RiskReference: ABC1234
              OriginalId: null
              RiskStatus: Quoted
              CancellationReasonId: null
              PolicyHolderIndividual: null
              Turnover: null
              Employees: null
              CancellationDate: null
              ProductId: PI UK
              BzyRiskReference: BZY65479321
              Underwriter: Tom Jones
              AnnualisedGrossPremium: 31750
              PrimaryCurrency: USD
              BenchmarkPricingIndicator: 0.8
              Parties:
              - Type: PrimaryInsured
                CustomerId: null
                Name: Rook Industries
                Parent: null
                PrimarySector: Industrial Technology & Research
                TechSector: true
                PrimaryContact: Sebastian Rooks
                PrimaryContactEmail: sebastian@rook.com
                PrimaryContactPhone: (140)-640-8191
                PrimaryAddress:
                  CityTown: Cambridge
                  Country: USA
                  FloorOrSuite: '2'
                  Line1: 77 Massachusetts Avenue
                  Line2: Building A
                  Line3: null
                  StateCountyProvince: MA
                  PostZipCode: 02139
              - Type: PlacingBroker
                CustomerId: null
                Name: Joseph & Joseph, London UK
                Parent: Joseph & Joseph
                PrimarySector: null
                TechSector: false
                PrimaryContact: Sam Spade
                PrimaryContactEmail: sam.spade@jj.com
                PrimaryContactPhone: (140)-555-5555
                PrimaryAddress:
                  CityTown: London
                  Country: GBR
                  FloorOrSuite: ''
                  Line1: null
                  Line2: null
                  Line3: null
                  StateCountyProvince: null
                  PostZipCode: null
              - Type: ProducingBroker
                CustomerId: null
                Name: Nimlane, Boston MA
                Parent: Nimlane USA
                PrimarySector: null
                TechSector: false
                PrimaryContact: Tiffany Harrison
                PrimaryContactEmail: tharrison@nimlane.com
                PrimaryContactPhone: (916)-975-8644
                PrimaryAddress:
                  CityTown: Boston
                  Country: USA
                  FloorOrSuite: null
                  Line1: null
                  Line2: null
                  Line3: null
                  StateCountyProvince: MA
                  PostZipCode: null
              Sections:
              - SectionUniqueId: null
                SectionReference: '001'
                SectionSequenceID: 1
                CoverageName: Buildings
                CreationDate: '2014-10-20T00:00:00.0000000+00:00'
                BindDate: '2014-10-20T00:00:00.0000000+00:00'
                InceptionDate: '2014-11-20T00:00:00.0000000+00:00'
                ExpiryDate: '2015-11-20T00:00:00.0000000+00:00'
                RetroactiveDate: '2010-10-20T00:00:00.0000000+00:00'
                EndorsementEffectiveDateFrom: null
                EndorsementEffectiveDateTo: null
                SectionStatus: Quoted
                Currency: USD
                GrossPremium: 1111111.99
                NetPremium: null
                Commissions:
                - Type: PlacingBroker
                  Rate: 0.03
                  TaxableAmount: 25000
                  Amount: 750
                - Type: ProducingBroker
                  Rate: 0.03
                  TaxableAmount: 25000
                  Amount: 750
                Taxes:
                - Type: State fire tax
                  Rate: 0.07
                  TaxableAmount: 25000
                  Amount: 1750
                - Type: GST
                  Rate: 0.2
                  TaxableAmount: 25000
                  Amount: 5000
                Limits:
                - Type: Limit per Claim, expenses in addition
                  Amount: 100000
                - Type: Limit per Claim, expenses in addition
                  Amount: 25000
                Assets:
                - Locations:
                  - AssetId: null
                    AssetName: Example location
                    CityTown: Cambridge
                    Country: USA
                    FloorOrSuite: '2'
                    Line1: 77 Massachusetts Avenue
                    Line2: Building A
                    Line3: null
                    StateCountyProvince: MA
                    PostZipCode: 02139
                  - AssetId: null
                    AssetName: Another example location
                    CityTown: Exeter
                    Country: UK
                    FloorOrSuite: ''
                    Line1: 1 Street
                    Line2: null
                    Line3: null
                    StateCountyProvince: Devon
                    PostZipCode: EX1 1DB
                  Insureds:
                  - AssetId: null
                    AssetName: Example insured
                    Parent: null
                    PrimarySector: Industrial Technology & Research
                    TechSector: true
                    Revenue: 20000000
                    RevenueCurrency: USD
                    PrimaryContact: Sebastian Rooks
                    PrimaryContactEmail: sebastian@rook.com
                    PrimaryContactPhone: (140)-640-8191
                    PrimaryAddress:
                      CityTown: Cambridge
                      Country: USA
                      FloorOrSuite: '2'
                      Line1: 77 Massachusetts Avenue
                      Line2: Building A
                      Line3: null
                      StateCountyProvince: MA
                      PostZipCode: 02139
              Installments:
              - PaymentType: Unknown
                PaymentCurrency: USD
                PaymentDueDate: '2014-10-25T00:00:00.0000000+00:00'
                GrossPremiumAmount: 2645.99
                CommissionPercentage: 0.03
                CommissionAmount: 100.99
                NetPremium: 100000.99
                TaxandFeesPremium: 1000.99
                FinalTotal: 1000000.99
      responses:
        '400':
          description: ''
        '201':
          description: New risk entry created successfully. Responds with the resource IDs which must be recorded for all future PUTs.
          content:
            application/json:
              example:
                Id: b767637a-9af9-446b-9622-55679fbaf543
                Parties:
                - Id: 4f9b856b-72c8-4972-9ccc-6a0bb70d7221
                  Type: PrimaryInsured
                - Id: d4ca7a16-3100-4481-a43c-bae04b0cb425
                  Type: PlacingBroker
                - Id: d277441e-1d51-4de9-ba82-8bc8d2474cd3
                  Type: ProducingBroker
                Sections:
                - Id: 41f8ddb5-9fee-4fc3-99a1-7d96b0e3cfeb
                  SectionReference: '001'
                  Assets:
                  - Insureds:
                    - Id: 342e3662-7545-4a47-9be4-0c2882b58f68
                      AssetName: Example insured
                    Locations:
                    - Id: 0894f765-e57f-4d49-9d08-c6a1ee86932a
                      AssetName: Example location
                    - Id: f7ecef59-b6d2-4d3c-af0b-5fe60af47431
                      AssetName: Another example location
      tags:
      - Risks
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      name: Ocp-Apim-Subscription-Key
      in: header
    apiKeyQuery:
      type: apiKey
      name: subscription-key
      in: query