Insurers Global Former API

openapi: 3.2.0
info:
  title: Insurers Global Former 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: Former
paths:
  /former/{slug}.json:
    get:
      operationId: getFormerEntity
      summary: One former company, its succession chain and the insurer listed today
      parameters:
      - name: slug
        in: path
        required: true
        description: Former entity slug
        schema:
          type: string
          pattern: ^[a-z0-9-]+$
        example: angola-ga-angola-seguros
      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
                  data:
                    $ref: '#/components/schemas/FormerEntity'
      tags:
      - Former
components:
  schemas:
    FormerEntity:
      type: object
      description: A company that no longer appears in the register under this name. Never a licensed insurer and counted in no total; kept so a policy naming an old company can be traced.
      properties:
        slug:
          type: string
        name:
          type: string
        country:
          type: string
        continent:
          type: string
          enum:
          - africa
          - europe
          - asia-pacific
          - south-america
          - north-america
        event:
          type: string
        eventCode:
          type: string
          enum:
          - RN
          - AQ
          - MG
          - TR
          - WD
          - FL
          - LR
        continuity:
          type: string
          enum:
          - continues
          - transferred
          - ended
          - failed
          - unknown
          description: How the company stopped being listed under this name. A renamed, acquired, merged or transferred insurer keeps its licence; only "failed" indicates failure, and "unknown" means the disappearance is evidenced but its cause is not.
        eventDate:
          type:
          - string
          - 'null'
          description: ISO date or a bare year. Do not assume a full date.
        successor:
          type:
          - string
          - 'null'
          description: Slug of the insurer listed today, or null when nothing survived.
        chain:
          type: array
          items:
            type: string
          description: Every step from here to the surviving insurer, in order.
        source:
          type: string
        notes:
          type:
          - string
          - 'null'
        id:
          type:
          - integer
          - 'null'
          description: 'Present only for a former page the daily register watch created: the workbook row it replaced, or null when the watch had added that row itself.'
        registerWatch:
          type: object
          description: Present only for a former page the daily register watch created.
          properties:
            type:
              type: string
              enum:
              - rename
              - remove
            date:
              type: string
              format: date
            sourceUrl:
              type: string
              format: uri
            review:
              type: string
              enum:
              - bot-researched
              - verified
        status:
          type: string
          description: Short human label for continuity, e.g. "Merged".
        summary:
          type: string
          description: One-sentence account of what happened, naming the successor when there is one.
        successorName:
          type:
          - string
          - 'null'
        successorUrl:
          type:
          - string
          - 'null'
          format: uri
      required:
      - slug
      - name
      - country
      - continent
      - event
      - eventCode
      - continuity
      - source
externalDocs:
  description: 'Agent guide: MCP server, WebMCP tools and this API'
  url: https://insurers.global/ai/