Geography Object

Articles can include geographic tags indicating what geography the article content discusses. Tags are either specific countries or broader geographic groups.

Geography entry types

Each entry in the geographies array has a type field indicating whether it references a country or a group.

Country entry

Attribute	Type	Description
`type`	string	Always `"country"`
`country`	string	ISO 3166-1 alpha-2 country code (e.g., `"GB"`, `"US"`)
`country_name`	string	Full country name (e.g., `"United Kingdom"`)

Group entry

Attribute	Type	Description
`type`	string	Always `"group"`
`group`	object	Group details
`group.id`	integer	Unique group identifier
`group.name`	string	Group display name (e.g., `"European Union"`)
`group.slug`	string	URL-friendly slug (e.g., `"european-union"`)

Example

An article about EU insurance regulation:

{
  "id": 12345,
  "heading": "EU Solvency II Reforms Impact Cross-Border Reinsurance",
  "geographies": [
    {
      "type": "group",
      "group": { "id": 5, "name": "European Union", "slug": "european-union" }
    }
  ]
}

An article about specific countries:

{
  "id": 12346,
  "heading": "Lloyd's Syndicates Eye US Hurricane Exposure",
  "geographies": [
    { "type": "country", "country": "GB", "country_name": "United Kingdom" },
    { "type": "country", "country": "US", "country_name": "United States" }
  ]
}