Beazley Microsites API

The Microsites API from Beazley — 3 operation(s) for microsites.

Operations 3

GET /microsites/{id}/contacts contacts by microsite (GET) #
GET /microsites/ microsites (GET) #
GET /microsites/{id}/organisations organisations by microsite (GET) #

Documentation

Specifications

Other Resources

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-microsites-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 email required.

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

OpenAPI Specification

beazley-microsites-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Beazley Microsites API
  version: '1.0'
  description: 'Operations tagged Microsites across 2 of this provider''s published API definitions: beazley-broker-and-insured-marketing-data-v2-sandbox.yml, beazley-broker-and-insured-marketing-data-v2.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.beazley.com/sandbox/marketing/v2
- url: https://api.beazley.com/marketing/v2
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Microsites
paths:
  /microsites/{id}/contacts:
    get:
      summary: contacts by microsite (GET)
      operationId: 561e208f8097920ed881e63a
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: ProviderID
        in: query
        required: true
        schema:
          type: string
      - name: UpdatedSince
        in: query
        schema:
          type: string
      - name: PageNumber
        in: query
        schema:
          type: string
      - name: RecordsPerPage
        in: query
        schema:
          type: string
      responses:
        '200':
          description: "<h4>Model</h4>\n<pre>\nContacts\n{\n     \"Id\" (string, <b>required</b>): <font color=\"brown\">Unique id of the contact,</font>\n     \"EmailAddress\" (string, <b>required</b>): <font color=\"brown\">Email address of the contact,</font>\n     \"FirstName\" (string, <b>required</b>): <font color=\"brown\">Given name of the contact,</font>\n     \"JobTitle\" (string, <b>optional</b>): <font color=\"brown\">Job title of the contact,</font>\n     \"LastName\" (string, <b>required</b>): <font color=\"brown\">Surname of the contact,</font>\n     \"MobilePhoneNumber\" (string, <b>optional</b>): <font color=\"brown\">Mobile telephone number of the contact,</font>\n     \"TelephoneNumber\" (string, <b>optional</b>): <font color=\"brown\">Groundline telephone number of the contact,</font>\n     \"CreatedOn\" (string, <b>required</b>): <font color=\"brown\">Date time that the contact record was created,</font>\n     \"UpdatedOn\" (string, <b>required</b>): <font color=\"brown\">Date time that the contact record was last updated,</font>\n     \"OrganisationId\" (string, <b>required</b>): <font color=\"brown\">id of the organisation linked to the contact,</font>\n     \"IsActive\" (boolean, <b>optional</b>): <font color=\"brown\">Active indicator,</font>\n     \"Industry\" (string, <b>optional</b>): <font color=\"brown\">Industry description,</font>\n     \"FocusArea\" (string, optional): <font color=\"brown\">Focus area,</font>\n     \"MicroSiteSubscriptions\": \n     [\n     {\n     \"SubscriberId\" (string, <b>optional</b>): <font color=\"brown\">Unique id of the microsite subscription,</font>\n          \"MicroSite\": \n          {\n               \"Id\" (string, <b>required</b>): <font color=\"brown\">Unique id of the microsite,</font>\n               \"Name\" (string, <b>required</b>): <font color=\"brown\">Name of the microsite</font> \n          },\n          \"StartDate\" (string, <b>optional</b>): <font color=\"brown\">Date time that the subscription starts,</font>\n          \"EndDate\" (string, <b>optional</b>): <font color=\"brown\">Date time that the subscription ends,</font>\n          \"PolicyType\" (string, <b>optional</b>): <font color=\"brown\">The policy renewal status: 0 for new, 1 for renewal,</font>\n     }\n     ]\n}\n</pre>"
          content:
            application/json:
              example:
                PageNumber: 1
                Contacts:
                - Id: 50f80afd-7fee-e411-80ff-0050568e7c76
                  EmailAddress: rita.foster79@example.com
                  FirstName: Rita
                  JobTitle: Health Inspector
                  LastName: Foster
                  MobilePhoneNumber: (859)-931-4822
                  TelephoneNumber: (484)-496-6034
                  CreatedOn: '2015-04-29T14:57:08.0000000+00:00'
                  UpdatedOn: '2015-04-29T14:58:47.0000000+00:00'
                  OrganisationId: 838a6fce-a2ed-e411-80ff-0050568e7c76
                  IsActive: true
                  Industry: Technology
                  FocusArea: Risk Management
                  MicroSiteSubscriptions:
                  - SubscriberId: 50f80afd-7fee-e411-80ff-0050568e7c76
                    MicroSite:
                      Id: 861d97ca-fdee-e411-80ff-0050568e7c76
                      Name: Breach Solutions
                    StartDate: '2015-03-31T23:00:00.0000000+00:00'
                    EndDate: '2016-03-31T23:00:00.0000000+00:00'
                    PolicyType: 0
      tags:
      - Microsites
    servers:
    - url: https://api.beazley.com/sandbox/marketing/v2
  /microsites/:
    get:
      summary: microsites (GET)
      operationId: 561e208f8097920ed881e63c
      parameters:
      - name: ProviderID
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              example:
              - Id: e3af7404-9d73-44d2-b5c1-2b4785ad8130
                Name: NoDataBreach.com
      tags:
      - Microsites
    servers:
    - url: https://api.beazley.com/sandbox/marketing/v2
  /microsites/{id}/organisations:
    get:
      summary: organisations by microsite (GET)
      operationId: 561e208f8097920ed881e640
      parameters:
      - name: id
        in: path
        description: Microsite ID
        required: true
        schema:
          type: string
      - name: ProviderID
        in: query
        description: Your unique provider ID
        required: true
        schema:
          type: string
      - name: UpdatedSince
        in: query
        description: Returns records updated since this date
        schema:
          type: string
      - name: PageNumber
        in: query
        description: Returns the results from page N
        schema:
          enum:
          - '1'
          type: string
      - name: RecordsPerPage
        in: query
        description: Sets the number of results per page. Maximum of 400
        schema:
          enum:
          - '400'
          type: string
      - name: AccessCode
        in: query
        description: Returns records that match a specific access code
        schema:
          type: string
      responses:
        '200':
          description: "<h4>Model</h4>\n<pre>\nOrganisations\n{\n     \"Name\" (string, <b>required</b>): <font color=\"brown\">Name of the organisation,</font>\n     \"NAICSCode\" (string, <b>required</b>): <font color=\"brown\">NAICS classification code of the organisation,</font>\n     \"Address\"  (string, <b>required</b>): <font color=\"brown\">Primary address of the organisation,</font>\n     {\n          \"CityTown\": \"Cambridge\",\n          \"Country\": \"United States\",\n          \"FloorOrSuite\": \"2\",\n          \"Line1\": \"12345 Main Street\",\n          \"Line2\": \"Suite 125\",\n          \"Line3\": null,\n          \"StateCountyProvince\": \"MA\",\n          \"PostZipCode\": \"02139\"\n     },\n     \"IsActive\"  (string, <b>optional</b>): <font color=\"brown\">Organisation active indicator,</font>\n}\n</pre>"
          content:
            application/json:
              example:
              - Organisation:
                  Id: 4781dc2e-d980-4a32-8158-937a06423005
                  MarketSegment: 1
                  Name: Rook Industries
                  NAICSCode: '541618'
                  AccessCode: touqng
                  ThirdPartyOrgRef: ABC123XYZ
                  Domain: www.rook.com
                  IsActive: true
                  Programs:
                  - Name: BBR Select
                  Address:
                    CityTown: Cambridge
                    Country: United States
                    FloorOrSuite: '2'
                    Line1: 77 Massachusetts Avenue
                    Line2: Building A
                    Line3: ''
                    StateCountyProvince: MA
                    PostZipCode: 02139
      tags:
      - Microsites
    servers:
    - url: https://api.beazley.com/sandbox/marketing/v2
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      name: Ocp-Apim-Subscription-Key
      in: header
    apiKeyQuery:
      type: apiKey
      name: subscription-key
      in: query
x-refined-from:
- beazley-broker-and-insured-marketing-data-v2-sandbox.yml
- beazley-broker-and-insured-marketing-data-v2.yml