---
title: "Full insurer list records for one country"
method: GET
path: "/countries/{slug}/insurers.json"
---

# Full insurer list records for one country

`GET /countries/{slug}/insurers.json`

## Request

- Base URL: `https://insurers.global/api/v1`
- URL: `https://insurers.global/api/v1/countries/{slug}/insurers.json`
- Auth: none declared

Same entity fields as /insurers.json, limited to one covered market. This is a static file; filter and paginate locally.

## Path parameters

- `slug` string, required

## Response `200`

OK

- object
  - `dataset` string
  - `version` string
  - `verified` string, date
  - `licence` string
  - `count` integer
  - `pages` object: Where the paged series of this list starts. Placed before data so a client whose fetch was cut off still reads it.
    - `pageSize` integer
    - `pageCount` integer
    - `first` string, uri
  - `data` Insurer[]
    - `id` integer, nullable: Workbook row number; null for a row the daily register watch added, which was never a workbook row.
    - `slug` string, required
    - `name` string, required
    - `continent` 'africa' | 'europe' | 'asia-pacific' | 'south-america' | 'north-america', required
    - `country` string, required: Country slug
    - `countryName` string
    - `countryIso2` string, nullable: null for composite markets
    - `region` string: Region slug
    - `class` string, required: Class of business slug
    - `classCode` 'G' | 'L' | 'C' | 'R' | 'T' | 'M' | 'X' | 'F' | 'H' | 'U', required: U = class not stated in the source register
    - `group` string: Parent / group text as the register records it. "Independent" when the register records no parent company. Read it as a parent organisation only when groupPlaceholder is false.
    - `groupSlug` string, nullable
    - `groupPlaceholder` boolean: True when group does not name a parent organisation: the register recorded none and the value is an ownership style, a status, a NAIC group code, a domicile or a description of the entity. Absence of a parent is not evidence of independence.
    - `groupType` string
    - `groupTypeCode` 'DO' | 'PA' | 'EU' | 'FM' | 'SO' | 'MU' | 'RG' | 'CP'
    - `regulator` string
    - `regulatorAcronym` string, required
    - `currency` string: ISO 4217
    - `sourceBasis` string
    - `notes` string, nullable
    - `verification` 'verified' | 'partial' | 'unverified', required
    - `lei` string, nullable: Legal Entity Identifier where the register carries it
    - `nationalId` string, nullable
    - `registeredSince` string, date, nullable
    - `city` string, nullable
    - `domicile` string, nullable: United States rows only (absent elsewhere): USPS code of the state or territory of domicile, from the register row. Null for a Lloyd’s syndicate or alien reinsurer. See /countries/united-states/states.json.
    - `website` string, uri, nullable
    - `classBasis` string, nullable: How the class was determined, e.g. "Register category" or "Inferred from name"
    - `groupBasis` string, nullable
    - `iaig` string, nullable: Slug of the Internationally Active Insurance Group (IAIS register) that ultimately controls the parent, see /iaigs.json
    - `iaigUrl` string, uri, nullable
    - `url` string, uri
    - `identity` object, nullable: GLEIF LEI record fields (legalName, legalAddress, headOfficeAddress, legalForm, registration, status, category), each as { value, source, seen }; null when the row has no LEI or was not yet collected
    - `footprint` object, nullable: Licensed footprint derived from GLEIF and the EIOPA register; null when not yet collected
      - `parent` object, nullable: A related legal entity from GLEIF Level 2 data
        - `lei` string
        - `name` string, nullable
        - `country` string, nullable: ISO alpha-2 of the legal address
        - `slug` string, nullable: Directory insurer slug when the LEI is listed
        - `source` string, uri: Record the value was read from
        - `seen` string, date: Date the source was last read
      - `ultimateParent` object, nullable: A related legal entity from GLEIF Level 2 data
        - `lei` string
        - `name` string, nullable
        - `country` string, nullable: ISO alpha-2 of the legal address
        - `slug` string, nullable: Directory insurer slug when the LEI is listed
        - `source` string, uri: Record the value was read from
        - `seen` string, date: Date the source was last read
      - `branchOf` object, nullable: A related legal entity from GLEIF Level 2 data
        - `lei` string
        - `name` string, nullable
        - `country` string, nullable: ISO alpha-2 of the legal address
        - `slug` string, nullable: Directory insurer slug when the LEI is listed
        - `source` string, uri: Record the value was read from
        - `seen` string, date: Date the source was last read
      - `passportsTo` object, nullable
        - `entries` object[]
          - `country` string: Host state, ISO alpha-2
          - `basis` 'FoS' | 'FoE': Freedom of services, or an EEA branch
          - `name` string, nullable: Branch name when it differs
        - `source` string, uri: Record the value was read from
        - `seen` string, date: Date the source was last read
      - `subsidiaries` string[]
      - `controlled` string[]
      - `branches` string[]
      - `groupConflict` boolean: The workbook group and the GLEIF parent point at different directory groups

---

[API](https://skmtc.dev/insurers/apis/insurers-global-api.md) · [All operations](https://skmtc.dev/insurers/apis/insurers-global-api/llms.txt) · [OpenAPI document](https://skmtc.dev/insurers/apis/insurers-global-api/revisions/6bfe8f0149bf?raw)