Beazley Fast Reader

Insurance glossary and knowledge API providing definitions of insurance terms, frequently asked questions by intent name, and Beazley product lookup by term. Published sandbox-only and backed by an Azure Logic App.

OpenAPI Specification

beazley-fast-reader.yml Raw ↑
openapi: 3.0.1
info:
  title: Fast Reader
  description: 'The Fast Reader API provides basic information on insurance terms, frequently asked questions (coming soon), and Beazley products (also coming soon).'
  version: '1.0'
servers:
  - url: https://api.beazley.com/sandbox/fastreader/v1
paths:
  /definitions:
    get:
      summary: definition by term
      description: Request the definition of a specific term
      operationId: 596757de398455123cd32ae7
      parameters:
        - name: term
          in: query
          description: the value you would like a definition for
          required: true
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          schema:
            enum:
              - application/json
            type: string
            default: application/json
      requestBody:
        description: The request body.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request-manual'
      responses:
        '200':
          description: Responds with details or one or more terms
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/'
        '204':
          description: 'successful call, but no matching content for the term provided'
    post:
      summary: definitions (POST)
      operationId: 596872adc8b9bbc2a3352428
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: true
          schema:
            enum:
              - application/json
            type: string
            default: application/json
      requestBody:
        description: The request body.
        content:
          application/json:
            example:
              term: catastrophe
              synonyms:
                - cataclysm
                - disaster
              abbreviations:
                - cat
              definition: 'Catastrophe (cat for short), is an event causing great and usually sudden damage or suffering; a disaster.'
      responses:
        '200':
          description: Responds with details or one or more terms
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/'
  /faqs/:
    get:
      summary: FAQs
      description: Get all Frequently Asked Questions
      operationId: 59675bb966f3f16555c931b0
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: true
          schema:
            enum:
              - application/json
            type: string
            default: application/json
      requestBody:
        description: The request body.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request-manual'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManualPathsInvokeDefinitions_term_Get200ApplicationJsonResponse'
  '/products/{term}':
    get:
      summary: products
      operationId: 59675c4259efa7b3b8c0fa3b
      parameters:
        - name: term
          in: path
          description: Product keyword or query term
          required: true
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          schema:
            enum:
              - application/json
            type: string
            default: application/json
      requestBody:
        description: The request body.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request-manual'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManualPathsInvokeDefinitions_term_Get200ApplicationJsonResponse'
  /definitions/:
    get:
      summary: definitions
      description: Retrieve all definitions
      operationId: 5971dd5476b7b3f0e01a426f
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: true
          schema:
            enum:
              - application/json
            type: string
            default: application/json
      requestBody:
        description: The request body.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request-manual'
      responses:
        '200':
          description: Responds with details or one or more terms
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/'
        '204':
          description: 'successful call, but no matching content for the term provided'
  /faqs:
    get:
      summary: FAQ by intent
      description: Get a specific Frequently Asked Question by the intent name
      operationId: 5972212f109c6c8fce68fc40
      parameters:
        - name: intentName
          in: query
          required: true
          schema:
            type: ''
        - name: Content-Type
          in: header
          description: ''
          required: true
          schema:
            enum:
              - application/json
            type: string
            default: application/json
      requestBody:
        description: The request body.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request-manual'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManualPathsInvokeDefinitions_term_Get200ApplicationJsonResponse'
components:
  schemas:
    request-manual: { }
    ManualPathsInvokeDefinitions_term_Get200ApplicationJsonResponse:
      type: object
      x-apim-schema-name: 'ManualPathsInvokeDefinitions{term}Get200ApplicationJsonResponse'
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      name: Ocp-Apim-Subscription-Key
      in: header
    apiKeyQuery:
      type: apiKey
      name: subscription-key
      in: query
security:
  - apiKeyHeader: [ ]
  - apiKeyQuery: [ ]