---
title: "One country including its full insurer list"
method: GET
path: "/countries/{slug}.json"
---

# One country including its full insurer list

`GET /countries/{slug}.json`

## Request

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

## Path parameters

- `slug` string, required

## Response `200`

OK

- object
  - `dataset` string
  - `version` string
  - `verified` string, date
  - `licence` string
  - `count` integer
  - `data` CountryDetail
    - `slug` string
    - `name` string
    - `continent` 'africa' | 'europe' | 'asia-pacific' | 'south-america' | 'north-america'
    - `iso2` string, nullable
    - `iso3` string, nullable
    - `isoNum` string, nullable
    - `composite` string[], nullable: ISO alpha-2 codes of the jurisdictions a composite market combines
    - `region` string
    - `regulator` object
      - `name` string
      - `acronym` string
      - `website` string, uri, nullable
      - `regime` string, nullable
      - `registerSource` string, nullable
    - `currency` string
    - `currencies` object[]: ISO 4217 currencies of the market, primary first; empty for composite markets whose members share none. usdRate is local units per US dollar, year-average, from the World Bank (CC BY 4.0), or null where no series is published.
      - `code` string: ISO 4217
      - `name` string
      - `symbol` string
      - `decimalDigits` integer
      - `countries` string[]
      - `usdRate` number, nullable
      - `usdRateYear` integer, nullable
      - `rateSource` string, nullable
      - `rateLicence` string, nullable
      - `rateSeen` string, date, nullable
    - `total` integer
    - `byClass` object: Counts by class count entities, not licences: every company appears once, under the class its register row records, and byClass sums to total. A regulator’s own per-class licence tally is broader and will not match.
    - `byGroupType` object
    - `verification` object
      - `level` 'verified' | 'partial' | 'unverified'
      - `basis` 'register' | 'statute' | 'null', nullable: What the rows were checked against: the supervisor’s register, or, where no register is published, the statute that provides for the insurers. Null when unverified.
      - `status` string
      - `source` string, nullable
      - `corrections` string, nullable
    - `marketNotes` object[]
      - `event` string
      - `effect` string, nullable
    - `url` string, uri
    - `api` string, uri
    - `insurersApi` string, uri: Full insurer list for this market
    - `insurersPagesApi` string, uri: First page of the market's insurers, 25 a page
    - `insurers` InsurerSummary[]
      - `slug` string, required
      - `name` string, required
      - `country` string, required
      - `class` string, required: Class of business slug
      - `classCode` 'G' | 'L' | 'C' | 'R' | 'T' | 'M' | 'X' | 'F' | 'H' | 'U': 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
      - `verification` 'verified' | 'partial' | 'unverified', required
      - `sourceBasis` string, required
      - `classBasis` string, nullable, required: How the class was determined
      - `groupBasis` string, nullable, required: How the parent or group was determined
      - `lei` string, nullable, required: LEI where the register carries it
      - `nationalId` string, nullable, required: National register identifier if available
      - `notes` string, nullable
      - `url` string, uri

---

[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)