Insurers Global Changes.json API

openapi: 3.2.0
info:
  title: Insurers Global Changes.json API
  version: 2026-09-08+97f331e66662
  summary: Static, read-only JSON API for the Insurers Global directory of licensed insurance companies.
  description: Every endpoint is a pre-rendered JSON file served from the Cloudflare edge with CORS enabled. There is no authentication and no rate limit beyond normal fair use. Slugs are stable lowercase identifiers used in page URLs. Attribute KAFS North America (Kenbright Actuarial and Financial Services North America) under CC BY 4.0.
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
  contact:
    name: Kenbright Actuarial and Financial Services North America
    url: https://www.kenbright.ai/
  termsOfService: https://insurers.global/terms/
  x-mcp:
    endpoint: https://insurers.global/mcp
    transport: streamable-http
    authentication: none
    health: https://insurers.global/mcp/health
    serverCard: https://insurers.global/.well-known/mcp/server-card.json
    configSchema: https://insurers.global/.well-known/mcp-config
servers:
- url: https://insurers.global/api/v1
tags:
- name: Changes.json
paths:
  /changes.json:
    get:
      operationId: listRegisterChanges
      summary: Adds, renames, removals and class changes applied by the daily register watch
      description: Every accepted change with its evidence and source. Read reviews with review "bot-researched" as unchecked by a person; "verified" means someone has checked the quote against the source.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  dataset:
                    type: string
                  version:
                    type: string
                  verified:
                    type: string
                    format: date
                  licence:
                    type: string
                  count:
                    type: integer
                  pages:
                    type: object
                    description: Where the paged series of this list starts. Placed before data so a client whose fetch was cut off still reads it.
                    properties:
                      pageSize:
                        type: integer
                      pageCount:
                        type: integer
                      first:
                        type: string
                        format: uri
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RegisterChange'
      tags:
      - Changes.json
components:
  schemas:
    RegisterChange:
      type: object
      description: 'One accepted change from the daily register watch, applied on top of the workbook by scripts/build-data.mjs: an add from the watch itself (review "bot-researched" until a person checks it), or a rename, removal or class change the owner accepted.'
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - add
          - rename
          - remove
          - class_change
        date:
          type: string
          format: date
        country:
          type: string
          description: Country slug
        continent:
          type: string
          enum:
          - africa
          - europe
          - asia-pacific
          - south-america
          - north-america
        company:
          type: string
        previousName:
          type:
          - string
          - 'null'
          description: The name the directory held before a rename; null otherwise.
        class:
          type:
          - string
          - 'null'
          description: Class of business slug, or null when the register states none.
        evidence:
          type: string
          description: A verbatim quote from the register text
        sourceUrl:
          type: string
          format: uri
        review:
          type: string
          enum:
          - bot-researched
          - verified
        reviewedOn:
          type:
          - string
          - 'null'
          format: date
          description: When a person checked the change; null while still bot-researched.
        slug:
          type: string
          description: 'The page this change resolves to: a live insurer page for an add, rename or class change, or the former page at the removed row’s own address for a removal.'
        formerSlug:
          type:
          - string
          - 'null'
          description: For a rename, the old slug that now carries the former page; null otherwise.
        group:
          type: string
          description: The ownership group named in the evidence, when given.
      required:
      - id
      - type
      - date
      - country
      - continent
      - company
      - evidence
      - sourceUrl
      - review
      - slug
externalDocs:
  description: 'Agent guide: MCP server, WebMCP tools and this API'
  url: https://insurers.global/ai/