Beazley

Beazley Contacts API

The Contacts API from Beazley — 4 operation(s) for contacts.

Documentation GitHub OpenAPI

Operations 4

POST /contacts/ contact (POST) #

PUT /Contacts/{id} contact (PUT) #

GET /contacts/{id} contact by id (GET) #

GET /contacts contacts (GET) #

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-contacts-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.

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: Beazley Contacts API
  version: '1.0'
  description: 'Operations tagged Contacts 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: Contacts
paths:
  /contacts/:
    post:
      summary: contact (POST)
      operationId: 561e208f8097920ed881e636
      parameters:
      - name: ProviderID
        in: query
        required: true
        schema:
          type: string
      requestBody:
        description: "<h4>Model</h4>\n<pre>\nContact \n{\n     EmailAddress (string, required): <font color=\"brown\">Email address of the contact,</font>\n     FirstName (string, required): <font color=\"brown\">Given name of the contact,</font>\n     LastName (string, required): <font color=\"brown\">Surname of the contact,</font>\n     OrganisationId (string, required): <font color=\"brown\">id of the organisation linked to the contact,</font>\n     JobTitle (string, optional): <font color=\"brown\">Job title of the contact,</font>\n     MobilePhoneNumber (string, optional): <font color=\"brown\">Mobile telephone number of the contact,</font>\n     TelephoneNumber (string, optional): <font color=\"brown\">Groundline telephone number of the contact,</font>\n     CreatedOn (datetime, optional): <font color=\"brown\">Creation date (ISO 8601),</font>\n     IsActive (boolean, optional): <font color=\"brown\">Active indicator,</font>\n     Industry (string, optional): <font color=\"brown\">Industry description,</font>\n     FocusArea (string, optional): <font color=\"brown\">Focus area.</font>\n}\n</pre>"
        content:
          application/json:
            example:
              Contact:
                EmailAddress: rita.foster79@example.com
                FirstName: Rita
                LastName: Foster
                OrganisationId: 9a89d986-f907-4b7b-87c3-50aac2040c64
                JobTitle: Health Inspector
                MobilePhoneNumber: (859)-931-4822
                TelephoneNumber: (484)-496-6034
                CreatedOn: '2014-10-20'
                IsActive: true
                Industry: Education
                FocusArea: Risk Management
      responses:
        '200':
          description: ''
          content:
            application/json:
              example:
                Id: 4254e883-55f5-e411-80ff-0050568e7c76
      tags:
      - Contacts
    servers:
    - url: https://api.beazley.com/sandbox/marketing/v2
  /Contacts/{id}:
    put:
      summary: contact (PUT)
      operationId: 561e208f8097920ed881e637
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: ProviderID
        in: query
        required: true
        schema:
          type: string
      requestBody:
        description: "<h4>Model</h4>\n<pre>\nContact \n{\n     EmailAddress (string, required): <font color=\"brown\">Email address of the contact,</font>\n     FirstName (string, required): <font color=\"brown\">Given name of the contact,</font>\n     LastName (string, required): <font color=\"brown\">Surname of the contact,</font>\n     OrganisationId (string, required): <font color=\"brown\">id of the organisation linked to the contact,</font>\n     JobTitle (string, optional): <font color=\"brown\">Job title of the contact,</font>\n     MobilePhoneNumber (string, optional): <font color=\"brown\">Mobile telephone number of the contact,</font>\n     TelephoneNumber (string, optional): <font color=\"brown\">Groundline telephone number of the contact,</font>\n     CreatedOn (datetime, optional): <font color=\"brown\">Creation date (ISO 8601),</font>\n     IsActive (boolean, optional): <font color=\"brown\">Active indicator,</font>\n     Industry (string, optional): <font color=\"brown\">Industry description,</font>\n     FocusArea (string, optional): <font color=\"brown\">Focus area.</font>\n}\n</pre>"
        content:
          application/json:
            example:
              Contact:
                EmailAddress: rita.foster79@example.com
                FirstName: Rita
                LastName: Foster
                JobTitle: Health Inspector
                MobilePhoneNumber: (859)-931-4822
                TelephoneNumber: (484)-496-6034
                IsActive: true
                Industry: Education
                FocusArea: Risk Management
      responses:
        '200':
          description: ''
      tags:
      - Contacts
    servers:
    - url: https://api.beazley.com/sandbox/marketing/v2
  /contacts/{id}:
    get:
      summary: contact by id (GET)
      operationId: 561e208f8097920ed881e638
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: ProviderID
        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:
      - Contacts
    servers:
    - url: https://api.beazley.com/sandbox/marketing/v2
  /contacts:
    get:
      summary: contacts (GET)
      operationId: 561e208f8097920ed881e639
      parameters:
      - 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
      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:
      - Contacts
    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