Insurers Global Changes API

openapi: 3.2.0
info:
  title: Insurers Global Changes 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
paths:
  /changes/pages/{n}.json:
    get:
      operationId: listRegisterChangesPaged
      summary: Register changes, 50 a page
      description: Compact JSON, 50 rows a page and every page under 96 KB, for clients whose fetch tool caps the text it returns. Same records and order as the unpaged file; the union of the pages is the file. Each page links first, prev, next and last.
      parameters:
      - name: n
        in: path
        required: true
        description: Page number, 1-based. Follow next until it is null.
        schema:
          type: integer
          minimum: 1
        example: 1
      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
                    description: Rows across all pages
                  page:
                    type: integer
                    minimum: 1
                  pageSize:
                    type: integer
                  pageCount:
                    type: integer
                  all:
                    type: string
                    format: uri
                    description: The unpaged list file
                  first:
                    type: string
                    format: uri
                  prev:
                    type:
                    - string
                    - 'null'
                    format: uri
                    description: null on the first page
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                    description: null on the last page
                  last:
                    type: string
                    format: uri
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RegisterChange'
                required:
                - count
                - page
                - pageSize
                - pageCount
                - first
                - prev
                - next
                - last
                - data
      tags:
      - Changes
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/